v1

latestOpenAPI 3.1.02026-07-2670105729.6 KB
Content

Generate an image

Generates an image via the Brew AI image pipeline. text-to-image (default) creates from a prompt; image-editing edits image1 (required) guided by the prompt. Returns a CDN-hosted URL. Usage-metered: charges the actual image gateway cost (no fixed price).

post/v1/content/generate-image

Headers

Idempotency-Keystring

Optional idempotency key for safe retries. Reusing the same key with the same request body returns the original response for 24 hours.

Request body

promptstring
mode'text-to-image' | 'image-editing'
aspectRatio'16:9' | '3:2' | '4:3' | '1:1' | '4:5' | '2:3' | '3:4' | '9:16'
image1string uri
image2string uri

Response

The operation result.

urlstring uri required
promptstring required
descriptionstring
warningsstring[]