wan/2-7-imagetext-to-imageimage-to-imageoutputs imagedocs.kie.aipast runsWidest aspect-ratio set of any in-scope model. color_palette items are { hex, ratio } objects, not bare hex strings, and bbox_list is one list of boxes PER input image — both are transcribed wrong easily and fail as a 422. RESOLUTION CEILING: 4K is text-to-image, standard-mode only. The input_urls half is confirmed against the live API (createTask returns code 500, "resolution is not within the range of allowed options"); the sequential half comes from this project's reference table and is not restated in the doc's current revision, which dropped the wording from the resolution field entirely. aspect_ratio is likewise read only in text-to-image — in edit mode Kie ignores it rather than rejecting it.1K/2K/4K · takes image
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.
image vs image_url vs image_urls vs image_input vs input_urls vs imageUrls — the same idea, two names55 modelsCopying a payload between these models silently drops the field, because the receiving model has never heard of that key. uses image: recraft/crisp-upscale, recraft/remove-background — uses image_url: kling/v2-5-turbo-image-to-video-pro, kling/v2-1-master-image-to-video, kling/v2-1-pro +16 — uses image_urls: kling-2.6/image-to-video, kling-3.0/video, kling/v3-turbo-image-to-video +16 — uses image_input: nano-banana-2, nano-banana-2-1, nano-banana-pro — uses input_urls: kling-2.6/motion-control, kling-3.0/motion-control, bytedance/seedance-1.5-pro +6 — uses imageUrls: veo3, veo3_fast, veo3_lite.
seed is not the same type on every model36 modelsSending the wrong JSON type is rejected as a 422 that names the field but not the reason. as number: bytedance/v1-pro-text-to-video, bytedance/v1-pro-image-to-video, bytedance/v1-lite-text-to-video +31 — as string: google/imagen4, google/imagen4-ultra.
watermark is not the same type on every model9 modelsSending the wrong JSON type is rejected as a 422 that names the field but not the reason. as boolean: wan/2-7-text-to-video, wan/2-7-image-to-video, wan/2-7-videoedit +3 — as string: veo3, veo3_fast, veo3_lite.
Widest aspect-ratio set of any in-scope model. color_palette items are { hex, ratio } objects, not bare hex strings, and bbox_list is one list of boxes PER input image — both are transcribed wrong easily and fail as a 422. RESOLUTION CEILING: 4K is text-to-image, standard-mode only. The input_urls half is confirmed against the live API (createTask returns code 500, "resolution is not within the range of allowed options"); the sequential half comes from this project's reference table and is not restated in the doc's current revision, which dropped the wording from the resolution field entirely. aspect_ratio is likewise read only in text-to-image — in edit mode Kie ignores it rather than rejecting it.
The form enforces these up front — it disables the conflicting control rather than letting you submit and reading back a 422.
forbiddenWhenthinking_mode, color_paletteThinking mode and the colour palette are unavailable in sequential mode.
forbiddenWhenthinking_modeThinking mode is text-to-image only — it is unavailable once an input image is supplied.
maxWhennOutside sequential mode this model generates at most 4 images.
allowedValuesWhenresolutionEditing an image caps the output at 2K — 4K is text-to-image only. Remove the input images to reach 4K.
allowedValuesWhenresolutionSequential mode caps the output at 2K.
forbiddenWhenaspect_ratioIn edit mode the output takes its shape from the input image, so the aspect ratio is ignored.
requiresbbox_listEdit regions are drawn on input images — add at least one image first.
| Field | Type | Accepts | Default |
|---|---|---|---|
promptrequiredGeneration or editing prompt. Chinese and English supported. | text | 0…5000 chars | — |
input_urlsSupplying images switches the model into edit mode. | url[] | 0…9 items, image | — |
aspect_ratioApplies only when no input image is supplied — in edit mode the output follows the input image. | enum | 1:1 | 16:9 | 4:3 | 21:9 | 3:4 | 9:16 | 8:1 | 1:8 | — |
enable_sequentialGenerate a related group of images rather than independent ones. | boolean | — | false |
nHow many images to generate. 1-4 normally (Kie defaults to 4), 1-12 in sequential mode (Kie defaults to 12). | number | 1…12, step 1 | 4 |
resolution4K is available only for text-to-image in standard mode — adding an input image or turning on sequential mode caps it at 2K. | enum | 1K | 2K | 4K | "2K" |
thinking_modeUnavailable with sequential mode or input images. | boolean | — | false |
color_paletteCustom color theme, each colour paired with the share of the image it should occupy. Between 3 and 10 colours; 8 is recommended. Unavailable in sequential mode. | color[] | 3…10 items | — |
bbox_listRegions to edit, drawn on each input image. Up to 2 per image, in the source image's own pixels as [x1, y1, x2, y2]. | bbox[][] | 0…2 items | — |
watermarkStamps "AI generated" in the lower-right corner. | boolean | — | false |
seedRandom seed for reproducibility. | seed | 0…2147483647, step 1 | 0 |
nsfw_checkerWhen off, results are returned directly by the model without filtering. | boolean | — | false |
The models most easily confused with this one.