Skip to main content
POST
Generate an image

Authorizations

Authorization
string
header
default:Bearer brew_your_api_key
required

Send your Brew API key as Authorization: Bearer brew_xxx.

Headers

Idempotency-Key
string

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

Required string length: 1 - 100
X-Brand-Id
string

The brand this request acts on. REQUIRED for organization-scoped credentials (otherwise 400 BRAND_ID_REQUIRED — there is no default brand); list ids with GET /v1/brands. Brand-scoped credentials may omit it, and sending a different brand returns 403 BRAND_SCOPE_MISMATCH. A brand outside your organization returns 404 BRAND_NOT_FOUND.

Required string length: 1 - 64

Body

application/json

Prompt + optional mode / aspect ratio / source images.

prompt
string
Required string length: 1 - 4000
mode
enum<string>
Available options:
text-to-image,
image-editing
aspectRatio
enum<string>
Available options:
16:9,
3:2,
4:3,
1:1,
4:5,
2:3,
3:4,
9:16
image1
string<uri>
image2
string<uri>
adCreative
object

Response

The operation result.

url
string<uri>
required
prompt
string
required
description
string
warnings
string[]