# Create an image.

Choose a compatible model after clarifying the brief and price.

Updated: 2026-09-21.
## Clarify the request

Ask for the subject, visual brief, aspect ratio, number of images and any required reference files. Do not fabricate missing identifiers, reference assets or file URLs.

## Choose a published tool

Use [discovery](/docs/discovery) and the [relevant catalog](/tools/image). Inspect the selected tool’s availability, complete input schema, pricing unit and reservation before execution. If no available tool fits, explain the missing capability instead of claiming a result.

## Execute with authority

Use an authenticated workspace. Confirm the required inputs, downstream effects and spending decision; keep a unique idempotency key for this intention. A public discovery connection alone cannot execute the tool.

## Read and recover

Preserve the run ID. Return the actual generated output and settled price; do not label a pending submission as a finished image.

On a retryable failure, preserve the run ID and idempotency key. On missing permission, input or credit, stop for the relevant decision. [Error recovery](/docs/errors) · [Asynchronous executions](/docs/async).

---

[HTML page](/docs/guides/images) · [Agent index](/llms.txt)