All guides
User

AI Image

Create or review AI output for this feature.

Step-by-step guide

Before you start

Use the account and workspace that own the records. This page does not include administrator configuration forms.

Open this feature

Open /portal/ai-studio/image on your application domain. The tasks below name the controls to use after opening the page.

Steps

The image feature, AI provider and applicable credit allowance must be available. Generating an image can use credits and call the configured provider.

Generate one image

  1. Open AI Image. Enter a Visual brief describing the subject, background, composition and any text requirements.
  2. For example: One red ceramic mug on a white desk, daylight, square composition, no text.
  3. Choose Style and Aspect ratio from the available options. Check the displayed credit requirement.
  4. Select Generate image once and wait for the result or error.
  5. Review the generated image for the intended subject and dimensions. Select Download when the result is available.
  6. To review an earlier result, select its entry in the job/history list instead of generating another image.

Fields shown in the interface

Field or settingWhat to enter or choose
Visual briefRequired, up to 4,000 characters. Describe the actual image you need.
StyleChoose an offered style; provider support depends on the installation.
Aspect ratioChoose the shape needed for the destination.
Credit requirementCheck the shown cost/allowance before generating. A disabled generation control may indicate insufficient credits.

Check the result

  • A result appears for the submitted brief and can be downloaded.
  • Check the downloaded file. A saved job or history entry alone does not prove that the image meets the request.

Problems and validation

ProblemWhat to do
Generate image is unavailableCheck feature access, the credit preview and the administrator’s provider setup.
Provider request failsRead the visible error before retrying. Repeated generation can submit further provider requests.
Image is unsuitableRevise the brief or settings and generate again only when another request is intended.

Technical reference

Sources for these task instructions
Role-scoped source references

Pinned commit: 40d27448e4517301d3d8f5a27ca0c7531c51f136

Source-only route information
MethodSource-default route
LIVEWIRE/portal/ai-studio/image