gpt-image-2-text-to-imagetext-to-imageoutputs imagedocs.kie.aipast runsSlug has no vendor prefix despite the market/gpt/ doc path. No documented default on aspect_ratio, resolution or background — the prose says aspect_ratio "is set to auto by default" but the schema states none, so nothing is sent unless chosen. Five ratios are 1K-only here; the image-to-image sibling restricts only two.1K/2K/4K
aspect_ratio vs ratio vs image_size — the same idea, two names67 modelsCopying a payload between these models silently drops the field, because the receiving model has never heard of that key. uses aspect_ratio: kling-2.6/text-to-video, kling/v2-5-turbo-text-to-video-pro, kling/v2-1-master-text-to-video +52 — uses ratio: wan/2-7-text-to-video — uses image_size: bytedance/seedream, bytedance/seedream-v4-text-to-image, bytedance/seedream-v4-edit +10. google/nano-banana and google/nano-banana-edit declare more than one of these spellings, so setting two of them on the same request sets one idea twice — check which the docs mark current.
resolution accepts different values on different models57 modelsA value that works on one of these is rejected on another. accepts 1080p,720p: kling/v3-turbo-text-to-video, kling/v3-turbo-image-to-video, bytedance/v1-pro-fast-image-to-video +12 — accepts 1080p,4k,720p: kling-3.0-omni/text-to-video, kling-3.0-omni/image-to-video, kling-3.0-omni/reference-to-video +5 — accepts 1080p,480p,4k,720p: bytedance/seedance-2 — accepts 480p,720p: bytedance/seedance-2-fast, bytedance/seedance-2-mini, wan/2-2-a14b-text-to-video-turbo +1 — accepts 1080p,480p,720p: bytedance/seedance-2-5, bytedance/seedance-1.5-pro, bytedance/v1-pro-text-to-video +3 — accepts 480p,580p,720p: wan/2-2-a14b-speech-to-video-turbo, wan/2-2-animate-move, wan/2-2-animate-replace — accepts 1080P,480P,720P: wan/3-0-video, wan/3-0-video-prime — accepts 1K,2K,4K: wan/2-7-image, wan/2-7-image-pro, nano-banana-2 +8 — accepts 1080p,360p,4k,720p: google/gemini-omni-flash-1-1 — accepts 1K,2K: qwen2-1/text-to-image, qwen2-1/image-to-image, qwen3/text-to-image +3.
aspect_ratio accepts different values on different models55 modelsA value that works on one of these is rejected on another. accepts 16:9,1:1,9:16: kling-2.6/text-to-video, kling/v2-5-turbo-text-to-video-pro, kling/v2-1-master-text-to-video +4 — accepts 16:9,1:1,9:16,auto: kling-3.0-omni/image-to-video, kling-3.0-omni/reference-to-video, kling-3.0-omni/transformation — accepts 16:9,1:1,21:9,3:4,4:3,9:16,adaptive: bytedance/seedance-2, bytedance/seedance-2-fast, bytedance/seedance-2-mini +1 — accepts 16:9,1:1,21:9,3:4,4:3,9:16: bytedance/seedance-1.5-pro, bytedance/v1-pro-text-to-video — accepts 16:9,1:1,3:4,4:3,9:16,9:21: bytedance/v1-lite-text-to-video — accepts 16:9,1:1,21:9,2:3,3:2,3:4,4:3,9:16: seedream/4.5-text-to-image, seedream/4.5-edit, seedream/5-lite-text-to-image +4 — accepts 16:9,9:16: wan/2-2-a14b-text-to-video-turbo, gemini-omni-video, google/gemini-omni-flash-1-1 — accepts 16:9,1:1,3:4,4:3,9:16: wan/2-7-videoedit, wan/2-7-r2v — accepts 16:9,1:1,3:4,4:3,9:16,adaptive: wan/3-0-video, wan/3-0-video-prime — accepts 16:9,1:1,1:8,21:9,3:4,4:3,8:1,9:16: wan/2-7-image, wan/2-7-image-pro — accepts 16:9,1:1,3:4,4:3,9:16,auto: google/imagen4, google/imagen4-fast, google/imagen4-ultra — accepts 16:9,1:1,21:9,2:3,3:2,3:4,4:3,4:5,5:4,9:16,auto: google/nano-banana, google/nano-banana-edit, nano-banana-pro — accepts 16:9,1:1,1:4,1:8,21:9,2:3,3:2,3:4,4:1,4:3,4:5,5:4,8:1,9:16,auto: nano-banana-2, nano-banana-2-1, nano-banana-2-lite — accepts 16:9,9:16,Auto: veo3, veo3_fast, veo3_lite — accepts 1:1,2:3,3:2: gpt-image/1.5-text-to-image, gpt-image/1.5-image-to-image — accepts 16:9,1:1,1:2,1:3,21:9,2:1,2:3,3:1,3:2,3:4,4:3,4:5,5:4,9:16,9:21,auto: gpt-image-2-text-to-image, gpt-image-2-image-to-image — accepts 16:27,16:9,1:1,21:9,27:16,2:3,3:2,3:4,4:3,8:9,9:16,9:8,auto: gpt-image-2-5-flare-text-to-image, gpt-image-2-5-flare-image-to-image, gpt-image-2-5-sunburst-text-to-image +1 — accepts 16:9,1:1,21:9,2:3,3:2,3:4,4:3,9:16,9:21: qwen2-1/text-to-image — accepts 16:9,1:1,21:9,2:3,3:2,3:4,4:3,9:16,9:21,auto: qwen2-1/image-to-image.
Slug has no vendor prefix despite the market/gpt/ doc path. No documented default on aspect_ratio, resolution or background — the prose says aspect_ratio "is set to auto by default" but the schema states none, so nothing is sent unless chosen. Five ratios are 1K-only here; the image-to-image sibling restricts only two.
The form enforces these up front — it disables the conflicting control rather than letting you submit and reading back a 422.
allowedValuesWhenresolutionAn automatic aspect ratio renders at 1K only — pick an explicit ratio to reach 2K or 4K, or the task fails to create.
allowedValuesWhenresolutionWith no aspect ratio chosen, this renders at 1K only — pick a ratio to reach 2K or 4K, or the task fails to create.
allowedValuesWhenresolutionSquare images cannot be rendered at 4K.
forbiddenWhenbackgroundBackground transparency is supported at 1K only.
forbiddenWhenbackgroundBackground transparency is supported at 1K only.
allowedValuesWhenresolutionThe 5:4 aspect ratio is supported at 1K only.
allowedValuesWhenresolutionThe 4:5 aspect ratio is supported at 1K only.
allowedValuesWhenresolutionThe 3:1 aspect ratio is supported at 1K only.
allowedValuesWhenresolutionThe 1:3 aspect ratio is supported at 1K only.
allowedValuesWhenresolutionThe 9:21 aspect ratio is supported at 1K only.
| Field | Type | Accepts | Default |
|---|---|---|---|
promptrequiredWhat you want to see. | text | 1…20000 chars | — |
aspect_ratioShape of the generated image. 5:4, 4:5, 3:1, 1:3 and 9:21 render at 1K only. | enum | auto | 1:1 | 3:2 | 2:3 | 4:3 | 3:4 | 5:4 | 4:5 | 16:9 | 9:16 | 2:1 | 1:2 | 3:1 | 1:3 | 21:9 | 9:21 | — |
resolutionWhich tiers are available depends on the aspect ratio — the control narrows itself as you choose one. | enum | 1K | 2K | 4K | — |
backgroundTransparency of the output. Supported at 1K only. | enum | transparent | opaque | auto | — |
The models most easily confused with this one.