Skip to main content

ImageGenerateInput

captionstring

Social media caption. Triggers standard mode. Takes priority over prompt.

Possible values: <= 2000 characters

platformstring

Required when caption is provided.

Example: instagram
templatestring | nullnullable

Possible values: [blog_cover, quote_card, stat_card, feature_announcement, product_highlight, event_promo, carousel_slide, ad_creative, null]

stylestring | nullnullable
Example: minimalist
brand_voicestring | nullnullable

Free-text tone for the image. When sent, it replaces the stored workspace brand voice for this call.

Possible values: <= 200 characters

Example: friendly
use_brand_voiceboolean | nullnullable

When brand_voice is not sent, derive the image tone from the workspace brand voice. Ignored in developer mode (prompt).

Default value: true
custom_instructionsstring | nullnullable

Possible values: <= 1000 characters

promptstring

Developer escape hatch. Bypasses internal prompt builder. Ignored if caption is present.

Possible values: <= 4000 characters

aspect_ratiostring | nullnullable

Possible values: [1:1, 16:9, 9:16, 4:5, null]

Default value: 1:1
countinteger

Possible values: >= 1 and <= 4

Default value: 1
qualitystring

Possible values: [standard, hd]

Default value: standard
ImageGenerateInput
{
"caption": "string",
"platform": "instagram",
"template": "blog_cover",
"style": "minimalist",
"brand_voice": "friendly",
"use_brand_voice": true,
"custom_instructions": "string",
"prompt": "string",
"aspect_ratio": "1:1",
"count": 1,
"quality": "standard"
}