Model reference

Every model on the Omni API and the endpoint to call. For media models, put the fields listed here in input, or read them from GET /v1/models/{id}. See the API documentation for how each endpoint works and pricing for what calls cost.

Contents

Language models

OpenAI and Anthropic request formats, streaming supported. Call them on the endpoint shown; most also work on /v1/responses and /v1/messages, and the API returns a clear 400 when one does not.

Language models
ModelMade byEndpoint
aion-3.0omniPOST /v1/chat/completions
aion-3.0-miniomniPOST /v1/chat/completions
claude-fable-5anthropicPOST /v1/chat/completions
claude-fable-5.1anthropicPOST /v1/chat/completions
claude-haiku-4.5anthropicPOST /v1/chat/completions
claude-haiku-5.5anthropicPOST /v1/messages
claude-opus-4.5anthropicPOST /v1/chat/completions
claude-opus-4.6anthropicPOST /v1/chat/completions
claude-opus-4.7anthropicPOST /v1/chat/completions
claude-opus-4.8anthropicPOST /v1/chat/completions
claude-opus-4.8-fastanthropicPOST /v1/chat/completions
claude-opus-5anthropicPOST /v1/chat/completions
claude-opus-5-fastanthropicPOST /v1/chat/completions
claude-opus-5.5anthropicPOST /v1/chat/completions
claude-sonnet-4.5anthropicPOST /v1/chat/completions
claude-sonnet-4.6anthropicPOST /v1/chat/completions
claude-sonnet-5anthropicPOST /v1/chat/completions
claude-sonnet-5.5anthropicPOST /v1/chat/completions
deepseek-v4-flashdeepseekPOST /v1/chat/completions
deepseek-v4-flash-0731deepseekPOST /v1/chat/completions
deepseek-v4-prodeepseekPOST /v1/chat/completions
deepseek-v4-pro-0813deepseekPOST /v1/chat/completions
deepseek-v4.1-flashdeepseekPOST /v1/chat/completions
gemini-2.5-flashgooglePOST /v1/chat/completions
gemini-2.5-progooglePOST /v1/chat/completions
gemini-3-flashgooglePOST /v1/chat/completions
gemini-3-progooglePOST /v1/chat/completions
gemini-3.1-flash-litegooglePOST /v1/chat/completions
gemini-3.1-progooglePOST /v1/chat/completions
gemini-3.5-flashgooglePOST /v1/chat/completions
gemini-3.5-flash-litegooglePOST /v1/chat/completions
gemini-3.6-flashgooglePOST /v1/chat/completions
gemini-3.7-flashgooglePOST /v1/chat/completions
gemini-3.8-flashgooglePOST /v1/chat/completions
gemini-4-argongooglePOST /v1/chat/completions
gemma-3-12b-itgooglePOST /v1/chat/completions
gemma-3-27b-itgooglePOST /v1/chat/completions
gemma-3-4b-itgooglePOST /v1/chat/completions
gemma-4-26b-a4b-itgooglePOST /v1/chat/completions
gemma-4-31b-itgooglePOST /v1/chat/completions
glm-4.5zhipuPOST /v1/chat/completions
glm-4.5-airzhipuPOST /v1/chat/completions
glm-4.6zhipuPOST /v1/chat/completions
glm-4.7zhipuPOST /v1/chat/completions
glm-4.7-flashzhipuPOST /v1/chat/completions
glm-5zhipuPOST /v1/chat/completions
glm-5.1zhipuPOST /v1/chat/completions
glm-5.2zhipuPOST /v1/chat/completions
glm-5.3zhipuPOST /v1/chat/completions
glm-5.3-flashzhipuPOST /v1/chat/completions
gpt-4.1-nanoopenaiPOST /v1/chat/completions
gpt-5-miniopenaiPOST /v1/chat/completions
gpt-5-nanoopenaiPOST /v1/chat/completions
gpt-5.2openaiPOST /v1/chat/completions
gpt-5.2-codexopenaiPOST /v1/chat/completions
gpt-5.4openaiPOST /v1/chat/completions
gpt-5.4-miniopenaiPOST /v1/chat/completions
gpt-5.4-nanoopenaiPOST /v1/chat/completions
gpt-5.5openaiPOST /v1/chat/completions
gpt-5.5-proopenaiPOST /v1/chat/completions
gpt-5.6-lunaopenaiPOST /v1/chat/completions
gpt-5.6-solopenaiPOST /v1/chat/completions
gpt-5.6-terraopenaiPOST /v1/chat/completions
gpt-6-astraopenaiPOST /v1/chat/completions
gpt-6-lunaopenaiPOST /v1/chat/completions
gpt-6-solopenaiPOST /v1/chat/completions
gpt-6.1-solopenaiPOST /v1/chat/completions
gpt-oss-120bopenaiPOST /v1/chat/completions
grok-4.3xaiPOST /v1/chat/completions
grok-4.5xaiPOST /v1/chat/completions
grok-4.6xaiPOST /v1/chat/completions
grok-4.7xaiPOST /v1/chat/completions
jev-1.13omniPOST /v1/chat/completions
kimi-k2-thinkingmoonshotPOST /v1/chat/completions
kimi-k2.5moonshotPOST /v1/chat/completions
kimi-k3moonshotPOST /v1/chat/completions
mimo-v2.6-flashxiaomiPOST /v1/chat/completions
mimo-v2.6-proxiaomiPOST /v1/chat/completions
minimax-m2minimaxPOST /v1/chat/completions
minimax-m2.1minimaxPOST /v1/chat/completions
minimax-m2.5minimaxPOST /v1/chat/completions
minimax-m2.7minimaxPOST /v1/chat/completions
minimax-m3minimaxPOST /v1/chat/completions
muse-spark-1.2metaPOST /v1/chat/completions
qwen3-32balibabaPOST /v1/chat/completions
qwen3-coder-30b-a3b-instructalibabaPOST /v1/chat/completions
qwen3-coder-nextalibabaPOST /v1/chat/completions
qwen3-next-80b-a3b-instructalibabaPOST /v1/chat/completions
qwen3-vl-235b-a22b-instructalibabaPOST /v1/chat/completions
qwen3.5-35b-a3balibabaPOST /v1/chat/completions
qwen3.6-27balibabaPOST /v1/chat/completions
qwen3.6-35b-a3balibabaPOST /v1/chat/completions
qwen3.8-2.4t-a95balibabaPOST /v1/chat/completions
qwen3.8-27balibabaPOST /v1/chat/completions
qwen3.8-flashalibabaPOST /v1/chat/completions
qwen3.8-maxalibabaPOST /v1/chat/completions

Image models with common fields

These take the common image fields: prompt, aspect_ratio or size, resolution, n and reference_urls. GET /v1/models/{id} shows each one’s aspect ratios, resolutions and reference limits, and POST /v1/images/quote gives the price before you run it.

Image models with common fields
ModelMade byEndpoint
bytedance-seedream-4bytedancePOST /v1/images/generations
bytedance-seedream-4.5bytedancePOST /v1/images/generations
bytedance-seedream-5-litebytedancePOST /v1/images/generations
bytedance-seedream-5-probytedancePOST /v1/images/generations
flux-1-kontextblack-forest-labsPOST /v1/images/generations
flux-2-problack-forest-labsPOST /v1/images/generations
gemini-2.5-flash-imagegooglePOST /v1/images/generations
gemini-3-pro-image-previewgooglePOST /v1/images/generations
gemini-3.1-flash-image-previewgooglePOST /v1/images/generations
gemini-3.1-flash-lite-imagegooglePOST /v1/images/generations
gpt-image-1openaiPOST /v1/images/generations
gpt-image-1.5openaiPOST /v1/images/generations
gpt-image-2openaiPOST /v1/images/generations
gpt-image-2.5-flareopenaiPOST /v1/images/generations
gpt-image-2.5-sunburstopenaiPOST /v1/images/generations
grok-imaginexaiPOST /v1/images/generations
kling-omni-imagekuaishouPOST /v1/images/generations
krea-2-largekreaPOST /v1/images/generations
krea-2-mediumkreaPOST /v1/images/generations
nano-bananagooglePOST /v1/images/generations
recraft-v4recraftPOST /v1/images/generations
recraft-v4.1recraftPOST /v1/images/generations
runway-gen4-imagerunwayPOST /v1/images/generations
runway-gen4-image-turborunwayPOST /v1/images/generations
wan-2.5-preview-imagealibabaPOST /v1/images/generations

Video models with common fields

These take prompt, image_urls, aspect_ratio, duration and resolution, and return the video in one call.

Video models with common fields
ModelMade byEndpoint
seedance-2.0bytedancePOST /v1/videos/generations

Image

bytedance/seedream · Seedream3.0 - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe text prompt used to generate the image (Max length: 5000 characters)
image_sizestringOutput size preset. One of square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Allowed: square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Default: square_hd.
guidance_scalenumberControls how closely the output image aligns with the input prompt. Higher values mean stronger prompt correlation. (Min: 1, Max: 10, Step: 0.1) (step: 0.1) Default: 2.5.
seedintegerRandom seed to control the stochasticity of image generation.
bytedance/seedream-v4-edit · Seedream4.0 - Edit · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe text prompt used to edit the image (Max length: 5000 characters)
image_urls (required)arrayList of URLs of input images for editing. Presently, up to 10 image inputs are allowed. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 30.0MB)
image_sizestringThe size of the generated image. Allowed: square, square_hd, portrait_4_3, portrait_3_2, portrait_16_9, landscape_4_3, landscape_3_2, landscape_16_9, landscape_21_9. Default: square_hd.
image_resolutionstringFinal image resolution is determined by combining image_size (aspect ratio) and image_resolution (pixel scale).. Allowed: 1K, 2K, 4K. Default: 1K.
max_imagesnumberSet this value (1–6) to cap how many images a single generation run can produce in one set—because they’re created in one shot rather than separate requests, you must also state the exact number you want in the prompt so both settings align. (Min: 1, Max: 6, Step: 1) (step: 1) Default: 1.
seedintegerRandom seed for reproducible results. Integer, up to 1000000. Omit for a random seed.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
bytedance/seedream-v4-text-to-image · Seedream4.0 - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe text prompt used to generate the image (Max length: 5000 characters)
image_sizestringThe size of the generated image. Allowed: square, square_hd, portrait_4_3, portrait_3_2, portrait_16_9, landscape_4_3, landscape_3_2, landscape_16_9, landscape_21_9. Default: square_hd.
image_resolutionstringFinal image resolution is determined by combining image_size (aspect ratio) and image_resolution (pixel scale).. Allowed: 1K, 2K, 4K. Default: 1K.
max_imagesnumberSet this value (1–6) to cap how many images a single generation run can produce in one set—because they’re created in one shot rather than separate requests, you must also state the exact number you want in the prompt so both settings align. (Min: 1, Max: 6, Step: 1) (step: 1) Default: 1.
seedintegerRandom seed for reproducible results. Integer, up to 1000000. Omit for a random seed.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
flux-2/flex-image-to-image · Flux-2 - Image to Image · POST /v1/images/generations
FieldTypeDetails
input_urls (required)arrayInput reference images (1-8 images). (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
prompt (required)stringMust be between 3 and 5000 characters. (Max length: 5000 characters)
aspect_ratio (required)stringRequired. Aspect ratio for the generated image. Select 'auto' to match the first input image ratio (requires input image). Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto.
resolution (required)stringRequired. Output image resolution. Allowed: 1K, 2K.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
flux-2/flex-text-to-image · Flux-2 - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringGeneration prompt, length must be between 3-5000 characters. (Maximum length: 5000 characters)
aspect_ratio (required)stringRequired. Aspect ratio of the generated image. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3.
resolution (required)stringRequired. Output image resolution. Allowed: 1K, 2K.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
flux-2/pro-image-to-image · Flux-2 - Pro Image to Image · POST /v1/images/generations
FieldTypeDetails
input_urls (required)arrayInput reference images (1-8 images). (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
prompt (required)stringMust be between 3 and 5000 characters. (Max length: 5000 characters)
aspect_ratio (required)stringRequired. Aspect ratio for the generated image. Select 'auto' to match the first input image ratio (requires input image). Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto.
resolution (required)stringRequired. Output image resolution. Allowed: 1K, 2K.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
flux-2/pro-text-to-image · Flux-2 - Pro Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringMust be between 3 and 5000 characters. (Max length: 5000 characters)
aspect_ratio (required)stringRequired. Aspect ratio for the generated image. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3.
resolution (required)stringRequired. Output image resolution. Allowed: 1K, 2K.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
flux-kontext · Generate or Edit Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompt describing the desired image or edit. Required for both generation and editing modes. - Should be detailed and specific - For image editing, describe the desired changes - For image generation, describe the complete scene - IMPORTANT: Only English language is supported
modelstringModel tier: flux-kontext-pro (default) or flux-kontext-max (higher quality, higher price). Allowed: flux-kontext-pro, flux-kontext-max. Default: flux-kontext-pro.
enable_translationbooleanWhether to enable automatic translation feature. - Since prompt only supports English, when this parameter is true, the system will automatically translate non-English prompts to English - If your prompt is already in English, you can set this to false - Default value: true
upload_cnboolean(Optional) Specifies the server region for image upload. Set to true to use servers in China, false to use non-China servers. Choose based on your geographical location for optimal upload speeds.
input_imagestringURL of the input image for editing mode. Required when editing an existing image. - Must be a valid image URL - Image must be accessible to the API server
aspect_ratiostringOutput image aspect ratio. You Applicable in both text-to-image generation and image editing modes. For **text-to-image generation** , the output image will follow the specified aspect ratio. For **image editing** , if aspect_ratio is provided, the edited image will follow that ratio. If not provided, the image will retain its original aspect ratio. Supported Aspect Ratios: | Ratio | Format Type | Allowed: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
output_formatstringOutput image format. Allowed: jpeg, png. Default: jpeg.
prompt_upsamplingboolean- If true, performs upsampling on the prompt - May increase processing time Default: false.
safety_toleranceinteger**For Image Generation Mode:** Moderation level for inputs and outputs. Value ranges from 0 (most strict) to 6 (more permissive). **For Image Editing Mode:** Moderation level for inputs and outputs. Value ranges from 0 (most strict) to 2 (balanced). Default: 2 Allowed: 0, 1, 2, 3, 4, 5, 6. Default: 2.
watermarkstringWatermark identifier to add to the generated image. - Optional - If provided, a watermark will be added to the output image
google/imagen4 · Google - imagen4 · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe text prompt describing what you want to see (Max length: 5000 characters)
negative_promptstringA description of what to discourage in the generated images (Max length: 5000 characters)
aspect_ratio (required)stringRequired. Aspect ratio of the output image: 1:1, 16:9, 9:16, 3:4, 4:3 or auto. Allowed: 1:1, 16:9, 9:16, 3:4, 4:3, auto.
seedstringRandom seed for reproducible generation (Max length: 500 characters)
google/imagen4-fast · Google - imagen4-fast · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe text prompt describing what you want to see (Max length: 5000 characters)
negative_promptstringA description of what to discourage in the generated images (Max length: 5000 characters)
aspect_ratio (required)stringRequired. Aspect ratio of the output image: 1:1, 16:9, 9:16, 3:4, 4:3 or auto. Allowed: 1:1, 16:9, 9:16, 3:4, 4:3, auto.
seedintegerRandom seed for reproducible generation
google/imagen4-ultra · Google - imagen4-ultra · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe text prompt describing what you want to see (Max length: 5000 characters)
negative_promptstringA description of what to discourage in the generated images (Max length: 5000 characters)
aspect_ratio (required)stringRequired. Aspect ratio of the output image: 1:1, 16:9, 9:16, 3:4, 4:3 or auto. Allowed: 1:1, 16:9, 9:16, 3:4, 4:3, auto.
seedstringRandom seed for reproducible generation (Max length: 500 characters)
google/nano-banana · Google - Nano Banana · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe prompt for image generation (Max length: 20000 characters)
output_formatstringOutput format for the images Allowed: png, jpeg. Default: png.
aspect_ratiostringAspect ratio of the output image. Set this field explicitly. Allowed: 1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto.
image_sizestringThe aspect ratio of the generated image (this parameter has been replaced by aspect_ratio; please use the latest aspect_ratio parameter). Allowed: 1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto. Default: 1:1.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
google/nano-banana-edit · Google - Nano Banana Edit · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe prompt for image editing (Max length: 20000 characters)
image_urls (required)arrayList of URLs of input images for editing,up to 10 images. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
output_formatstringOutput format for the images Allowed: png, jpeg. Default: png.
aspect_ratiostringAspect ratio of the output image. Set this field explicitly. Allowed: 1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto.
image_sizestringThe aspect ratio of the generated image (this parameter has been replaced by aspect_ratio; please use the latest aspect_ratio parameter). Allowed: 1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto. Default: 1:1.
gpt-4o-image · Generate 4o Image · POST /v1/images/generations
FieldTypeDetails
promptstring(Optional) Text prompt that conveys the creative idea you want the 4o model to render. Required if neither `files_url` nor `file_url` is supplied. At least one of `prompt` or `files_url` must be provided.
files_urlarray(Optional) Up to 5 publicly reachable image URLs to serve as reference or source material. Use this when you want to edit or build upon an existing picture. If you don’t have reliable hosting, upload your images first via our File Upload API quick‑start: Supported formats: .jfif, .pjpeg, .jpeg, .pjp, .jpg, .png, .webp. At least one of `prompt` or `files_url` must be provided.
size (required)string(Required) Aspect ratio of the generated image. Must be one of the listed values. Allowed: 1:1, 3:2, 2:3.
file_urlstring(Optional, Deprecated) File URL, such as an image URL. If file_url is provided, 4o image may create based on this image. This parameter will be deprecated in the future, please use files_url instead.
gpt-image-2-5-flare-image-to-image · GPT Image 2.5 Flare - Image To Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompts, up to 20,000 characters.
input_urlsarrayArray of input image URLs.
aspect_ratiostringThe aspect ratio of the generated image is set to auto by default. The 27:16, 16:27, 9:8 and 8:9 aspect ratios support 1K only. 2K and 4K are available for other aspect ratios. Allowed: auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 27:16, 16:27, 9:8, 8:9.
resolutionstringImage resolution Allowed: 1K, 2K, 4K.
backgroundstringImage background Allowed: transparent, opaque, auto.
gpt-image-2-5-flare-text-to-image · GPT Image 2.5 Flare - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompt. Required, maximum 20,000 characters.
aspect_ratiostringThe aspect ratio of the generated image is set to auto by default. The 27:16, 16:27, 9:8 and 8:9 aspect ratios support 1K only. 2K and 4K are available for other aspect ratios. Allowed: auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 27:16, 16:27, 9:8, 8:9.
resolutionstringImage resolution Allowed: 1K, 2K, 4K.
backgroundstringImage background Allowed: transparent, opaque, auto.
gpt-image-2-5-sunburst-image-to-image · GPT Image 2.5 Sunburst - Image To Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompts, up to 20,000 characters.
input_urlsarrayArray of input image URLs.
aspect_ratiostringThe aspect ratio of the generated image is set to auto by default. The 27:16, 16:27, 9:8 and 8:9 aspect ratios support 1K only. 2K and 4K are available for other aspect ratios. Allowed: auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 27:16, 16:27, 9:8, 8:9.
resolutionstringImage resolution Allowed: 1K, 2K, 4K.
backgroundstringImage background Allowed: transparent, opaque, auto.
gpt-image-2-5-sunburst-text-to-image · GPT Image 2.5 Sunburst - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompt. Required, maximum 20,000 characters.
aspect_ratiostringThe aspect ratio of the generated image is set to auto by default. The 27:16, 16:27, 9:8 and 8:9 aspect ratios support 1K only. 2K and 4K are available for other aspect ratios. Allowed: auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 27:16, 16:27, 9:8, 8:9.
resolutionstringImage resolution Allowed: 1K, 2K, 4K.
backgroundstringImage background Allowed: transparent, opaque, auto.
gpt-image-2-image-to-image · GPT Image 2 - Image To Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompts, up to 20,000 characters.
input_urlsarrayArray of input image URLs.
aspect_ratiostringThe aspect ratio of the generated image is set to auto by default. Note: for 2K resolution, the following aspect ratios are not supported: 5:4, 4:5, 3:1, 1:3, and 9:21. for 4K resolution, the following aspect ratios are not supported: 3:1, 1:3, and 9:21. Allowed: 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.
resolutionstringOutput resolution: 1K, 2K or 4K. Set this field explicitly. 2K does not support 5:4, 4:5, 3:1, 1:3 or 9:21; 4K does not support 3:1, 1:3 or 9:21. The background parameter is only available at 1K. Allowed: 1K, 2K, 4K.
backgroundstringImage background Note: This parameter is only supported when the resolution is 1K. Allowed: transparent, opaque, auto.
gpt-image-2-text-to-image · GPT Image-2 - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompt. Required, maximum 20,000 characters.
aspect_ratiostringThe aspect ratio of the generated image is set to auto by default. Note: for 2K resolution, the following aspect ratios are not supported: 5:4, 4:5, 3:1, 1:3, and 9:21. for 4K resolution, the following aspect ratios are not supported: 3:1, 1:3, and 9:21. Allowed: 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.
resolutionstringOutput resolution: 1K, 2K or 4K. Set this field explicitly. 2K does not support 5:4, 4:5, 3:1, 1:3 or 9:21; 4K does not support 3:1, 1:3 or 9:21. The background parameter is only available at 1K. Allowed: 1K, 2K, 4K.
backgroundstringImage background Note: This parameter is only supported when the resolution is 1K. Allowed: transparent, opaque, auto.
gpt-image/1.5-image-to-image · GPT Image-1.5 - Image to Image · POST /v1/images/generations
FieldTypeDetails
input_urls (required)arrayUpload an image file to use as input for the API (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
prompt (required)stringA text description of the image you want to generate
aspect_ratio (required)stringRequired. Width-height ratio of the image, determining its visual form. Allowed: 1:1, 2:3, 3:2.
quality (required)stringRequired. Quality: medium=balanced, high=slow/detailed. Allowed: medium, high.
gpt-image/1.5-text-to-image · GPT Image-1.5 - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringA text description of the image you want to generate
aspect_ratio (required)stringRequired. Width-height ratio of the image, determining its visual form. Allowed: 1:1, 2:3, 3:2.
quality (required)stringRequired. Quality: medium=balanced, high=slow/detailed. Allowed: medium, high.
grok-imagine-image-2-0/image-edit · Grok Imagine Image 2.0 Image Edit · POST /v1/images/generations
FieldTypeDetails
promptstringA text description specifying the desired content or style of the generated image. Up to 8,000 characters.
aspect_ratio (required)stringSpecifies the width-to-height ratio of the generated image. Controls the aspect ratio of the output. This field is required. Allowed: 1:1, 2:3, 3:2, 16:9, 9:16, auto.
image_urls (required)arrayAn array containing up to 5 and at least 1 URL strings pointing to a reference image.
grok-imagine-image-2-0/segment-edit · Grok Imagine Image 2.0 Segment Edit · POST /v1/generations
FieldTypeDetails
prompt (required)stringText prompt describing the desired image. Up to 65,000 characters.
task_id (required)stringThe source task ID to use for image editing(This can be a task ID generated by the `grok-imagine-image-2-0/text-to-image` model, or a task ID generated by the `grok-imagine-image-2-0/segment-map` model by passing an `image_url`.).
mask_indexsarrayIndexes of the segments to edit, taken from resultObject.segments[].index of the segment-map task (0-based). Example: [0, 2].
grok-imagine-image-2-0/segment-map · Grok Imagine Image 2.0 Segment Map · POST /v1/generations

No input fields beyond the prompt.

grok-imagine-image-2-0/text-to-image · Grok Imagine Image 2.0 Text To Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompt describing the desired image. This field is required. Up to 8,000 characters.
aspect_ratio (required)stringSpecifies the width-to-height ratio of the generated image. Controls the aspect ratio of the output. This field is required. Allowed: 1:1, 2:3, 3:2, 16:9, 9:16.
grok-imagine/image-to-image · Grok Imagine - image to image · POST /v1/images/generations
FieldTypeDetails
promptstringA text description specifying the desired content or style of the generated image. (Max length: 390000 characters)
image_urls (required)array1–5 image URLs. (Use file URLs after upload, not raw file content. Accepted types: image/jpeg, image/png, image/webp. Max size: 10.0MB per image.) In your prompt, reference the uploaded image by typing @image(n) followed by a space (for example: @image1 a sunset over the ocean).
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
grok-imagine/text-to-image · Grok Imagine - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompt describing the desired image. Required field. - Should be detailed and specific about the desired visual elements - Describe composition, style, lighting, mood, and other visual details - Maximum length: 5000 characters - Supports English language prompts
aspect_ratio (required)stringRequired. Aspect ratio of the output image: 2:3, 3:2, 1:1, 16:9, 9:16. Allowed: 2:3, 3:2, 1:1, 16:9, 9:16.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
enable_probooleanControls the request processing strategy. - `false`: Corresponds to **speed mode**. The system prioritizes response time and throughput, suitable for latency-sensitive scenarios. - `true`: Corresponds to **quality mode**. The system prioritizes processing quality and precision, suitable for scenarios requiring higher accuracy.
ideogram/character · Ideogram - Character · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe prompt describing the scene to generate with the referenced character. (Max length: 5000 characters)
reference_image_urls (required)arrayA set of images to use as character references. Currently only 1 image is supported, rest will be ignored. (maximum total size 10MB across all character references). The images should be in JPEG, PNG or WebP format (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
rendering_speedstringThe rendering speed to use. Default value: "BALANCED" Allowed: TURBO, BALANCED, QUALITY. Default: BALANCED.
stylestringThe style type to generate with. Default value: "AUTO" Allowed: AUTO, REALISTIC, FICTION. Default: AUTO.
expand_promptbooleanDetermine if MagicPrompt should be used in generating the request or not. Default value: true (Boolean value (true/false))
num_imagesstringNumber of images to generate. Allowed: 1, 2, 3, 4. Default: 1.
image_sizestringThe resolution of the generated image Default value: square_hd Allowed: square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Default: square_hd.
seedintegerSeed for the random number generator
negative_promptstringDescription of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt. Default value: "" (Max length: 5000 characters)
ideogram/character-edit · Ideogram - Character Edit · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe prompt to fill the masked part of the image. (Max length: 5000 characters)
image_url (required)stringThe image URL to generate an image from. Should have the same aspect ratio as the mask. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
mask_url (required)stringThe mask URL to inpaint the image. Should have the same aspect ratio as the input image. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
reference_image_urls (required)arrayA set of images to use as character references. Currently only 1 image is supported, rest will be ignored. (maximum total size 10MB across all character references). The images should be in JPEG, PNG or WebP format (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
rendering_speedstringThe rendering speed to use. Default value: "BALANCED" Allowed: TURBO, BALANCED, QUALITY. Default: BALANCED.
stylestringThe style type to generate with. Default value: "AUTO" Allowed: AUTO, REALISTIC, FICTION. Default: AUTO.
expand_promptbooleanDetermine if MagicPrompt should be used in generating the request or not. Default value: true (Boolean value (true/false))
num_imagesstringNumber of images to generate. Allowed: 1, 2, 3, 4. Default: 1.
seedintegerSeed for the random number generator
ideogram/character-remix · Ideogram - Character Remix · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe prompt to remix the image with (Max length: 5000 characters)
image_url (required)stringThe image URL to remix (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
reference_image_urls (required)arrayA set of images to use as character references. Currently only 1 image is supported, rest will be ignored. (maximum total size 10MB across all character references). The images should be in JPEG, PNG or WebP format (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
rendering_speedstringThe rendering speed to use. Default value: "BALANCED" Allowed: TURBO, BALANCED, QUALITY. Default: BALANCED.
stylestringThe style type to generate with. Default value: "AUTO" Allowed: AUTO, REALISTIC, FICTION. Default: AUTO.
expand_promptbooleanDetermine if MagicPrompt should be used in generating the request or not. Default value: true (Boolean value (true/false))
image_sizestringOutput image size. Allowed: square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Default: square_hd.
num_imagesstringNumber of images to generate. Allowed: 1, 2, 3, 4. Default: 1.
seedintegerSeed for the random number generator
strengthnumberStrength of the input image in the remix Default value: 0.8 (Min: 0.1, Max: 1, Step: 0.1) (step: 0.1) Default: 0.8.
negative_promptstringDescription of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt. Default value: "" (Max length: 500 characters)
image_urlsarrayA set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
reference_mask_urlsstringA set of masks to apply to the character references. Currently only 1 mask is supported, rest will be ignored. (maximum total size 10MB across all character references). The masks should be in JPEG, PNG or WebP format (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
ideogram/v3-edit · Ideogram V3 Edit · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe prompt to fill the masked part of the image. Maximum length: 5000 characters.
image_url (required)stringThe image URL to generate an image from. Needs to match the dimensions of the mask. - Please provide the URL of the uploaded file, not raw file content - Accepted types: `image/jpeg`, `image/png`, `image/webp` - Max size: 10.0MB
mask_url (required)stringThe mask URL to inpaint the image. Needs to match the dimensions of the input image. - Please provide the URL of the uploaded file, not raw file content - Accepted types: `image/jpeg`, `image/png`, `image/webp` - Max size: 10.0MB
rendering_speedstringThe rendering speed to use. Default value: `BALANCED`. - `TURBO`: Turbo - `BALANCED`: Balanced - `QUALITY`: Quality Allowed: TURBO, BALANCED, QUALITY. Default: BALANCED.
expand_promptbooleanDetermine if MagicPrompt should be used in generating the request or not. Default value: `true`. - Boolean value: `true` / `false` Default: true.
seedintegerSeed for the random number generator.
ideogram/v3-remix · Ideogram V3 Remix · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe prompt to remix the image with. Maximum length: 5000 characters.
image_url (required)stringThe image URL to remix. - Please provide the URL of the uploaded file, not raw file content - Accepted types: `image/jpeg`, `image/png`, `image/webp` - Max size: 10.0MB
rendering_speedstringThe rendering speed to use. - `TURBO`: Turbo - `BALANCED`: Balanced - `QUALITY`: Quality Allowed: TURBO, BALANCED, QUALITY.
stylestringThe style type to generate with. - `AUTO`: Auto - `GENERAL`: General - `REALISTIC`: Realistic - `DESIGN`: Design Allowed: AUTO, GENERAL, REALISTIC, DESIGN.
expand_promptbooleanDetermine if MagicPrompt should be used in generating the request or not. - Boolean value: `true` / `false`
image_sizestringThe resolution of the generated image. - `square`: Square - `square_hd`: Square HD - `portrait_4_3`: Portrait 3:4 - `portrait_16_9`: Portrait 9:16 - `landscape_4_3`: Landscape 4:3 - `landscape_16_9`: Landscape 16:9 Allowed: square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9.
num_imagesstringNumber of images to generate. - `1`: 1 image - `2`: 2 images - `3`: 3 images - `4`: 4 images Allowed: 1, 2, 3, 4.
seedintegerSeed for the random number generator.
strengthnumberStrength of the input image in the remix. - Minimum: `0.01` - Maximum: `1` - Step: `0.01`
negative_promptstringDescription of what to exclude from the generated image. If the positive prompt conflicts with the negative prompt, the positive prompt takes precedence. Maximum length: 5000 characters.
ideogram/v3-text-to-image · Ideogram V3 Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringDescription of the image to generate. Maximum length: 5000 characters.
rendering_speedstringThe rendering speed to use. - `TURBO`: Turbo - `BALANCED`: Balanced - `QUALITY`: Quality Allowed: TURBO, BALANCED, QUALITY.
stylestringThe style type to generate with. - `AUTO`: Auto - `GENERAL`: General - `REALISTIC`: Realistic - `DESIGN`: Design Allowed: AUTO, GENERAL, REALISTIC, DESIGN.
expand_promptbooleanDetermines whether MagicPrompt should be used to enhance the generation request. - Boolean value: `true` / `false`
image_sizestringThe resolution of the generated image. - `square`: Square - `square_hd`: Square HD - `portrait_4_3`: Portrait 3:4 - `portrait_16_9`: Portrait 9:16 - `landscape_4_3`: Landscape 4:3 - `landscape_16_9`: Landscape 16:9 Allowed: square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9.
seedintegerSeed for the random number generator.
negative_promptstringDescription of what to exclude from the generated image. If the positive prompt conflicts with the negative prompt, the positive prompt takes precedence. Maximum length: 5000 characters.
nano-banana-2 · Google - Nano Banana 2 · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringA text description of the image you want to generate (Max length: 20000 characters)
image_inputarrayInput images to transform or use as reference (supports up to 10 images) (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 30.0MB)
aspect_ratiostringAspect ratio of the generated image Allowed: 1:1, 2:3, 3:2, 1:4, 4:1, 3:4, 4:3, 4:5, 5:4, 1:8, 8:1, 9:16, 16:9, 21:9, auto. Default: auto.
resolutionstringResolution of the generated image Allowed: 1K, 2K, 4K. Default: 1K.
output_formatstringFormat of the output image Allowed: png, jpg. Default: jpg.
nano-banana-2-1 · Google - Nano Banana 2.1 · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringA text description of the image you want to generate (Max length: 20000 characters)
image_inputarrayInput images to transform or use as reference (supports up to 10 images) (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 30.0MB)
aspect_ratiostringAspect ratio of the generated image Allowed: 1:1, 2:3, 3:2, 1:4, 4:1, 3:4, 4:3, 4:5, 5:4, 1:8, 8:1, 9:16, 16:9, 21:9, auto. Default: auto.
resolutionstringResolution of the generated image Allowed: 1K, 2K, 4K. Default: 1K.
output_formatstringFormat of the output image Allowed: png, jpg. Default: jpg.
nano-banana-2-lite · Google - Nano Banana 2 Lite · POST /v1/images/generations
FieldTypeDetails
image_urlsarrayInput image URL array. Optional parameter. Set to an empty array or omit it for pure text-to-image generation. Supports up to 10 images. - Please provide uploaded file URLs, not raw file content - Accepted types: `image/jpeg`, `image/png`, `image/webp` - Max size: 30.0MB
prompt (required)stringText prompt used to generate the image. Required. Maximum length: 20000 characters.
aspect_ratio (required)stringRequired. Aspect ratio of the output image. Use "auto" to let the model decide. Allowed: 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9, auto.
nano-banana-pro · Google - Nano Banana Pro · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringA text description of the image you want to generate (Max length: 20000 characters)
image_inputarrayInput images to transform or use as reference (supports up to 8 images) (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 30.0MB)
aspect_ratiostringAspect ratio of the generated image Allowed: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto. Default: 1:1.
resolutionstringResolution of the generated image Allowed: 1K, 2K, 4K. Default: 1K.
output_formatstringOutput image format: png or jpg. Set this field explicitly. Allowed: png, jpg.
qwen/image-edit · Qwen - Image Edit · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe prompt to generate the image with (Max length: 2000 characters)
image_url (required)stringThe URL of the image to edit. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
accelerationstringAcceleration level for image generation. Options: 'none', 'regular', 'high'. Higher acceleration increases speed. 'regular' balances speed and quality. Default value: "none" Allowed: none, regular, high. Default: none.
image_sizestringThe size of the generated image. Default value: landscape_4_3 Allowed: square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Default: landscape_4_3.
num_inference_stepsnumberThe number of inference steps to perform. Default value: 30 (Min: 2, Max: 49, Step: 1) (step: 1) Default: 25.
seedintegerThe same seed and the same prompt given to the same version of the model will output the same image every time.
guidance_scalenumberThe CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. Default value: 4 (Min: 0, Max: 20, Step: 0.1) (step: 0.1) Default: 4.
num_imagesstringnum_images Allowed: 1, 2, 3, 4.
enable_safety_checkerbooleanIf set to true, the safety checker will be enabled. Default value: true (Boolean value (true/false))
output_formatstringThe format of the generated image. Default value: "png" Allowed: jpeg, png. Default: png.
negative_promptstringThe negative prompt for the generation Default value: " " (Max length: 500 characters)
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
qwen/image-to-image · Qwen - Image to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe prompt to generate the image with (Max length: 5000 characters)
image_url (required)stringThe reference image to guide the generation (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
strengthnumberDenoising strength. 1.0 = fully remake; 0.0 = preserve original (Min: 0, Max: 1, Step: 0.01) (step: 0.01) Default: 0.8.
output_formatstringThe format of the generated image Allowed: png, jpeg. Default: png.
accelerationstringAcceleration level for image generation. Options: 'none', 'regular', 'high'. Higher acceleration increases speed. 'regular' balances speed and quality. 'high' is recommended for images without text Allowed: none, regular, high. Default: none.
negative_promptstringThe negative prompt for the generation (Max length: 500 characters)
seedintegerThe same seed and the same prompt given to the same version of the model will output the same image every time
num_inference_stepsnumberThe number of inference steps to perform (Min: 2, Max: 250, Step: 1) (step: 1) Default: 30.
guidance_scalenumberThe CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you (Min: 0, Max: 20, Step: 0.1) (step: 0.1) Default: 2.5.
enable_safety_checkerbooleanThe safety checker is always enabled in Playground. It can only be disabled by setting false through the API. (Boolean value (true/false))
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
qwen/text-to-image · Qwen - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe prompt to generate the image with (Max length: 5000 characters)
image_sizestringThe size of the generated image. Set this field explicitly. Allowed: square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9.
num_inference_stepsnumberThe number of inference steps to perform (Min: 2, Max: 250, Step: 1) (step: 1) Default: 30.
seedintegerThe same seed and the same prompt given to the same version of the model will output the same image every time
guidance_scalenumberThe CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you (Min: 0, Max: 20, Step: 0.1) (step: 0.1) Default: 2.5.
enable_safety_checkerbooleanThe safety checker is always enabled in Playground. It can only be disabled by setting false through the API. (Boolean value (true/false))
output_formatstringThe format of the generated image Allowed: png, jpeg. Default: png.
negative_promptstringThe negative prompt for the generation (Max length: 500 characters)
accelerationstringAcceleration level for image generation. Options: 'none', 'regular', 'high'. Higher acceleration increases speed. 'regular' balances speed and quality. 'high' is recommended for images without text Allowed: none, regular, high. Default: none.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
qwen2-1/image-to-image · Qwen 2.1 - Image to Image · POST /v1/images/generations
FieldTypeDetails
image_urls (required)arrayReference images, given as an array of 1 to 10 http(s) URLs. Required. The order of the array is the order the prompt refers to ("the first image", "the second image"). JPEG, PNG and WebP are supported, up to 30MB and 25MP each, and every URL must be directly retrievable with a GET. If an image URL cannot be fetched, the task fails with failCode 400. With more than 10 entries the request is reject
prompt (required)stringThe prompt describing the result you want. Required. Any language is supported, up to 5000 characters; if it is longer, the request is rejected. When `mask_url` is supplied, use it to describe what should be generated inside the white area of the mask.
mask_urlstringInpainting mask that switches the request into local-edit mode. A black and white image where **white marks the area to change and black is kept unchanged**, with a few pixels of feathering along the boundary. It must be used with exactly one entry in `image_urls`, otherwise the request is rejected. The mask should have the same aspect ratio as that reference image; a mask of a different size is s
aspect_ratiostringOutput aspect ratio. Defaults to `auto`, which takes the aspect ratio of the first reference image and snaps it to the nearest supported ratio. The actual pixel size also depends on `resolution`. Ignored in local-edit mode. Allowed: auto, 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, 9:21. Default: auto.
resolutionstringOutput resolution tier. `1K` is the faster option; `2K` produces four times the pixels and takes considerably longer, up to about 3 minutes with reference images. Only `1K` and `2K` are accepted — with any other value, including `4K`, the request is rejected. Allowed: 1K, 2K. Default: 1K.
backgroundstringBackground type. transparent outputs a PNG or WebP with a real alpha channel and cannot be used with JPEG. When using transparent, describe only the subject — prompts that mention a background, scene, surface, etc. may produce a non-transparent result. Allowed: opaque, transparent. Default: opaque.
output_formatstringOutput image format. `png` (default) and `webp` both carry an alpha channel and can be used with `background: transparent`. `jpeg` has no alpha channel and cannot be combined with a transparent background. Allowed: png, webp, jpeg. Default: png.
enhance_promptbooleanRewrites the prompt into a fuller scene description before generating, which noticeably improves quality. Enabled by default (also when the parameter is omitted); pass false to turn it off. Default: true.
seedintegerThe random seed. Omit it to generate with a random seed. Passing the same seed together with the same prompt and parameters reproduces the same image within the same service version.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
qwen2-1/text-to-image · Qwen 2.1 - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe prompt that describes the image content, style and composition you want to generate. Required. Any language is supported, up to 5000 characters; if it is longer, the request is rejected.
aspect_ratiostringThe output aspect ratio. Default `1:1`. The actual pixel size also depends on `resolution`. Allowed: 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, 9:21. Default: 1:1.
resolutionstringThe output resolution tier. `1K` is the faster option; `2K` produces four times the pixels and takes longer. Only `1K` and `2K` are accepted — with any other value, including `4K`, the request is rejected. Allowed: 1K, 2K. Default: 1K.
backgroundstringBackground type. transparent outputs a PNG or WebP with a real alpha channel and cannot be used with JPEG. When using transparent, describe only the subject — prompts that mention a background, scene, surface, etc. may produce a non-transparent result. Allowed: opaque, transparent. Default: opaque.
output_formatstringThe output image format. `png` (default) and `webp` both carry an alpha channel and can be used with `background: transparent`. `jpeg` has no alpha channel and cannot be combined with a transparent background. Allowed: png, webp, jpeg. Default: png.
enhance_promptbooleanRewrites the prompt into a fuller scene description before generating, which noticeably improves quality. Enabled by default (also when the parameter is omitted); pass false to turn it off. Default: true.
seedintegerThe random seed. Omit it to generate with a random seed. Passing the same seed together with the same prompt and parameters reproduces the same image within the same service version.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
qwen2/image-edit · Qwen2 - Image Edit · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe prompt to generate the image with (Max length: 800 characters)
image_url (required)arrayURLs of the images to edit. Supports up to 3 images. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
image_sizestringThe size of the generated image. Default value: 16:9 Allowed: 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9. Default: 16:9.
seedintegerThe same seed and the same prompt given to the same version of the model will output the same image every time.
output_formatstringOutput format: png or jpeg. Set this field explicitly. Allowed: jpeg, png.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
qwen2/text-to-image · Qwen2 - Text To Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe prompt to generate the image with. Max length: 5000 characters.
image_sizestringThe size of the generated image. Default value: 16:9 Allowed: 1:1, 3:4, 4:3, 9:16, 16:9. Default: 16:9.
seedintegerThe same seed and the same prompt given to the same version of the model will output the same image every time.
output_formatstringOutput format: png or jpeg. Set this field explicitly. Allowed: jpeg, png.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
qwen3/image-to-image · Qwen3 Image to Image · POST /v1/images/generations
FieldTypeDetails
image_urls (required)arrayInput image URL array. Upload images and provide their URLs rather than the file content. Supports up to 3 images. Supported file types: `image/jpeg`, `image/png`, `image/webp`, `image/bmp`, and `image/gif`,`image/tiff`. Maximum file size: 10 MB per image.
prompt (required)stringThe positive prompt that describes the image content, style, and composition you want to generate or edit. Both Chinese and English are supported.
resolutionstringThe output image resolution. Allowed: 1K, 2K. Default: 1K.
image_sizestringThe output image size. Allowed: 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9. Default: 16:9.
output_formatstringOutput format: png or jpeg. Set this field explicitly. Allowed: png, jpeg.
prompt_extendbooleanWhether to enable intelligent prompt rewriting. Default: true (recommended). When enabled, the model optimizes the positive prompt, which significantly improves results for simple descriptions. Default: true.
negative_promptstringThe negative prompt that describes content you do not want to appear in the image.
seedintegerRandom seed, 0–2147483647. If omitted, a random seed is used.
nsfw_checkerbooleanWhether to enable content filtering. Optional. Defaults to false. When set to false, content filtering is disabled and all results are returned directly by the model. Note: Content filtering cannot guarantee that all inappropriate content will be detected. If the filtering results do not meet your requirements, you must implement additional content moderation measures. Default: false.
qwen3/pro-image-to-image · Qwen3 Pro Image to Image · POST /v1/images/generations
FieldTypeDetails
image_urls (required)arrayInput image URL array. Upload images and provide their URLs rather than the file content. Supports up to 3 images. Supported file types: `image/jpeg`, `image/png`, `image/webp`, `image/bmp`, and `image/gif`,`image/tiff`. Maximum file size: 10 MB per image.
prompt (required)stringThe positive prompt that describes the image content, style, and composition you want to generate or edit. Both Chinese and English are supported.
resolutionstringThe output image resolution. Allowed: 1K, 2K. Default: 1K.
image_sizestringThe output image size. Allowed: 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9. Default: 16:9.
output_formatstringOutput format: png or jpeg. Set this field explicitly. Allowed: png, jpeg.
prompt_extendbooleanWhether to enable intelligent prompt rewriting. Default: true (recommended). When enabled, the model optimizes the positive prompt, which significantly improves results for simple descriptions. Default: true.
negative_promptstringThe negative prompt that describes content you do not want to appear in the image.
seedintegerRandom seed, 0–2147483647. If omitted, a random seed is used.
nsfw_checkerbooleanWhether to enable content filtering. Optional. Defaults to false. When set to false, content filtering is disabled and all results are returned directly by the model. Note: Content filtering cannot guarantee that all inappropriate content will be detected. If the filtering results do not meet your requirements, you must implement additional content moderation measures. Default: false.
qwen3/pro-text-to-image · Qwen3 Pro Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe positive prompt that describes the image content, style, and composition you want to generate or edit. Both Chinese and English are supported.
resolutionstringThe output image resolution. Allowed: 1K, 2K.
image_sizestringThe output image size. Allowed: 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9. Default: 16:9.
output_formatstringOutput format: png or jpeg. Set this field explicitly. Allowed: png, jpeg.
prompt_extendbooleanWhether to enable intelligent prompt rewriting. Default: true (recommended). When enabled, the model optimizes the positive prompt, which significantly improves results for simple descriptions. Default: true.
negative_promptstringThe negative prompt that describes content you do not want to appear in the image.
seedintegerRandom seed, 0–2147483647. If omitted, a random seed is used.
nsfw_checkerbooleanWhether to enable content filtering. Optional. Defaults to false. When set to false, content filtering is disabled and all results are returned directly by the model. Note: Content filtering cannot guarantee that all inappropriate content will be detected. If the filtering results do not meet your requirements, you must implement additional content moderation measures. Default: false.
qwen3/text-to-image · Qwen3 Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringThe positive prompt that describes the image content, style, and composition you want to generate or edit. Both Chinese and English are supported.
resolutionstringThe output image resolution. Allowed: 1K, 2K.
image_sizestringThe output image size. Allowed: 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9. Default: 16:9.
output_formatstringOutput format: png or jpeg. Set this field explicitly. Allowed: png, jpeg.
prompt_extendbooleanWhether to enable intelligent prompt rewriting. Default: true (recommended). When enabled, the model optimizes the positive prompt, which significantly improves results for simple descriptions. Default: true.
negative_promptstringThe negative prompt that describes content you do not want to appear in the image.
seedintegerRandom seed, 0–2147483647. If omitted, a random seed is used.
nsfw_checkerbooleanWhether to enable content filtering. Optional. Defaults to false. When set to false, content filtering is disabled and all results are returned directly by the model. Note: Content filtering cannot guarantee that all inappropriate content will be detected. If the filtering results do not meet your requirements, you must implement additional content moderation measures. Default: false.
recraft/remove-background · Recraft - Remove Background · POST /v1/generations
FieldTypeDetails
image (required)stringImage to remove background from. Supported formats: PNG, JPG, WEBP. Max 5MB, max 16MP, max dimension 4096px, min dimension 256px. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 5.0MB)
seedream/4.5-edit · Seedream4.5 - Edit · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringA text description of the image you want to generate (Max length: 3000 characters)
image_urls (required)arrayUpload an image file to use as input for the API (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 30.0MB)
aspect_ratio (required)stringRequired. Width-height ratio of the image, determining its visual form. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9.
quality (required)stringRequired. Basic outputs 2K images, while High outputs 4K images. Allowed: basic, high.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
seedream/4.5-text-to-image · Seedream4.5 - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringA text description of the image you want to generate (Max length: 3000 characters)
aspect_ratio (required)stringRequired. Width-height ratio of the image, determining its visual form. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9.
quality (required)stringRequired. Basic outputs 2K images, while High outputs 4K images. Allowed: basic, high.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
seedream/5-flash-image-to-image · Seedream5.0 Flash - Image to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompt, 4–5000 characters.
image_urls (required)arrayUpload an image file to use as input for the API (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 30.0MB)
aspect_ratio (required)stringRequired. Width-height ratio of the image, determining its visual form. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9.
sizestringResolution level of the output image. Allowed: 1K, 1.5K, 2K. Default: 1K.
output_formatstringOutput image format. Set this field explicitly. Allowed: png, jpeg.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
seedream/5-flash-layer-decomposition · Seedream5.0 Flash - Layer Decomposition · POST /v1/generations
FieldTypeDetails
promptstringOptional prompt for layer separation. - When a prompt is provided, the model separates the specified elements based on the prompt - When no prompt is provided, the model automatically identifies the main elements in the image - Supports using ` x1 y1 x2 y2 ` to precisely specify element positions, recommending the use of normalized coordinates in the 0-1000 range - Length: 4–5000 characters
image_url (required)stringThe source image URL for layer separation. - Must upload exactly 1 image - Supported formats: PNG, JPEG. - Image size must not exceed 30 MB - Total pixel range is 262,144-36,000,000 - Aspect ratio range is 1:16-16:1
sizestringResolution level of the output image. The base image maintains the aspect ratio of the input image, and each separated layer maintains the aspect ratio of the corresponding element in the original image. - `auto`: Automatically selected based on the input image size - `1K`: 1K resolution level - `1.5K`: 1.5K resolution level - `2K`: 2K resolution level Allowed: auto, 1K, 1.5K, 2K. Default: auto.
output_formatstringOutput format of the base image. This parameter only controls the base image format; all separated layers are fixed to output as PNG. Allowed: png, jpeg. Default: jpeg.
seedream/5-flash-text-to-image · Seedream5.0 Flash - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompt, 4–5000 characters.
aspect_ratio (required)stringRequired. Width-height ratio of the image, determining its visual form. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9.
sizestringResolution level of the output image. Allowed: 1K, 1.5K, 2K. Default: 1K.
output_formatstringOutput image format. Set this field explicitly. Allowed: png, jpeg.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
seedream/5-lite-image-to-image · Seedream5.0 Lite - Image to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompt, 4–2995 characters.
image_urls (required)arrayUpload an image file to use as input for the API (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 30.0MB)
aspect_ratio (required)stringRequired. Width-height ratio of the image, determining its visual form. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9.
quality (required)stringRequired. Basic outputs 2K images, while High outputs 3K images, and Ultra outputs 4K images. Allowed: basic, high, ultra.
output_formatstringOutput image format. Set this field explicitly. Allowed: png, jpeg.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
seedream/5-lite-text-to-image · Seedream5.0 Lite - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompt, 4–2995 characters.
aspect_ratio (required)stringRequired. Width-height ratio of the image, determining its visual form. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9.
quality (required)stringRequired. Basic outputs 2K images, while High outputs 3K images, and Ultra outputs 4K images. Allowed: basic, high, ultra.
output_formatstringOutput image format. Set this field explicitly. Allowed: png, jpeg.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
seedream/5-pro-image-to-image · Seedream5.0 Pro - Image to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompt, 4–5000 characters.
image_urls (required)arrayUpload an image file to use as input for the API (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 30.0MB)
aspect_ratio (required)stringRequired. Width-height ratio of the image, determining its visual form. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9.
quality (required)stringRequired. Basic outputs 1K images, while High outputs 2K images. Allowed: basic, high.
output_formatstringFormat of the output image Allowed: png, jpeg. Default: png.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
seedream/5-pro-layer-decomposition · Seedream5.0 Pro - Layer Decomposition · POST /v1/generations
FieldTypeDetails
promptstringOptional prompt for layer separation. - When a prompt is provided, the model separates the specified elements based on the prompt - When no prompt is provided, the model automatically identifies the main elements in the image - Supports using ` x1 y1 x2 y2 ` to precisely specify element positions, recommending the use of normalized coordinates in the 0-1000 range
image_url (required)stringThe source image URL for layer separation. - Must upload exactly 1 image - Supported formats: PNG, JPEG. - Image size must not exceed 30 MB - Total pixel range is 262,144-36,000,000 - Aspect ratio range is 1:16-16:1
size (required)stringRequired. Output resolution tier: auto, 1K, 1.5K or 2K. auto follows the input image size. Allowed: auto, 1K, 1.5K, 2K.
output_formatstringOutput format of the base image. This parameter only controls the base image format; all separated layers are fixed to output as PNG. Allowed: png, jpeg. Default: jpeg.
seedream/5-pro-text-to-image · Seedream5.0 Pro - Text to Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringText prompt, 4–5000 characters.
aspect_ratio (required)stringRequired. Width-height ratio of the image, determining its visual form. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9.
quality (required)stringRequired. Basic outputs 1K images, while High outputs 2K images. Allowed: basic, high.
output_formatstringFormat of the output image Allowed: png, jpeg. Default: png.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-7-image · Wan 2.7 Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringPrompt for image generation or editing. This field supports both Chinese and English, with a maximum length of 5000 characters.
input_urlsarray(Optional) Array of input image URLs.
aspect_ratiostring(Optional) Output aspect ratio when no image input is provided. Allowed: 1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8.
enable_sequentialbooleanWhether to enable sequential/group image mode. Default is false. Default: false.
nintegerNumber of images to generate. Range is 1-4 when `enable_sequential=false` (default: 4); range is 1-12 when `enable_sequential=true` (default: 12).
resolutionstringOutput resolution: 1K or 2K (default 2K). For 4K, use wan/2-7-image-pro. Allowed: 1K, 2K. Default: 2K.
thinking_modebooleanWhether to enable thinking mode. Only available when `enable_sequential=false` and `input_urls` is empty; it is disabled in other cases. Default: false.
color_palettearray(Optional) Custom color theme. Only available when `enable_sequential=false`. Requires 3-10 colors, 8 recommended.
bbox_listarray(Optional) Interactive editing bounding box areas. The outer list length should match `input_urls`; maximum 2 boxes per image; single box format is `[x1, y1, x2, y2]`.
watermarkbooleanWhether to add watermark. Default: false.
seedintegerOptional. Omit for a random seed.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-7-image-pro · Wan 2.7 Image Pro · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringPrompt for image generation or editing. This field supports both Chinese and English, with a maximum length of 5000 characters.
input_urlsarray(Optional) Array of input image URLs.
aspect_ratiostring(Optional) Output aspect ratio when no image input is provided. Allowed: 1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8.
enable_sequentialbooleanWhether to enable sequential/group image mode. Default is false. Default: false.
nintegerNumber of images to generate. Range is 1-4 when `enable_sequential=false` (default: 4); range is 1-12 when `enable_sequential=true` (default: 12).
resolutionstringOutput resolution: 1K, 2K or 4K (default 2K). 4K is available only for text-to-image (no input images) with sequential generation off. Allowed: 1K, 2K, 4K. Default: 2K.
thinking_modebooleanWhether to enable thinking mode. Only available when `enable_sequential=false` and `input_urls` is empty; it is disabled in other cases. Default: false.
color_palettearray(Optional) Custom color theme. Only available when `enable_sequential=false`. Requires 3-10 colors, 8 recommended.
bbox_listarray(Optional) Interactive editing bounding box areas. The outer list length should match `input_urls`; maximum 2 boxes per image; single box format is `[x1, y1, x2, y2]`.
watermarkbooleanWhether to add watermark. Default: false.
seedintegerOptional. Omit for a random seed.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
z-image · Z-Image · POST /v1/images/generations
FieldTypeDetails
prompt (required)stringA text description of the image you want to generate (Max length: 1000 characters)
aspect_ratio (required)stringRequired. Aspect ratio for the generated image. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.

Video

bytedance/seedance-1.5-pro · Bytedance Seedance 1.5 Pro · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt used to generate the video. Required field. (Min length: 3, Max length: 20000 characters)
input_urlsarrayURLs of input images for image-to-video generation. Optional field. - Accepts 0-2 images - If not provided, the model will perform text-to-video generation - File URLs after upload, not file content - Accepted types: image/jpeg, image/png, image/webp - Max size per image: 10.0MB
aspect_ratio (required)stringRequired. One of 1:1, 4:3, 3:4, 16:9, 9:16, 21:9. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9.
resolutionstringVideo resolution - 480p for faster generation, 720p for balance, 1080p for higher quality Allowed: 480p, 720p, 1080p. Default: 720p.
duration (required)numberRequired. Output length in whole seconds, 4–12.
fixed_lensbooleanSeedance adds dynamic camera movement. Enable this feature to lock the camera for stable, static shots. - **true**: Lock camera for static shots - **false**: Allow dynamic camera movement Default: false.
generate_audiobooleanWhether to generate synchronized audio. Default: true. Pass false for a silent video. Audio doubles the per-second price. Default: true.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
bytedance/seedance-2 · bytedance-seedance-2 · POST /v1/videos/generations
FieldTypeDetails
promptstringThe text prompt used to generate the video. Required field. (Min length: 3, Max length: 20000 characters)
first_frame_urlstringFirst frame image url or asset://{assetId} (for example: asset://asset-20260404242101-76djj)
last_frame_urlstringEnd frame image url or asset://{assetId} (for example: asset://asset-20260404242101-76djj)
reference_image_urlsarrayEnter a list of image URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj). Single image requirements: Format: jpeg, png, webp, bmp, tiff, gif. Aspect ratio (width/height): (0.4, 2.5) Width and height (px): (300, 6000) Size: Single image less than 30 MB. Up to 9 images.
reference_video_urlsarrayEnter a list of video URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj) . Single video requirements: Video format: mp4, mov. Resolution: 480p, 720p Duration: Single video duration [2, 15] s, maximum 3 reference videos, total duration of all videos not exceeding 15 seconds. Dimensions: Aspect ratio (width/height): [0.4, 2.5] Width/height (px): [300, 6000] Total pixels: [64
reference_audio_urlsarrayEnter a list of audio URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj) . Single audio requirements: Format: wav, mp3 Duration: Single audio duration [2, 15] s, maximum 3 reference audios, total duration of all audios not exceeding 15 s. Size: Single audio file size not exceeding 15 MB.
return_last_framebooleanWhether to return the last frame of the video as an image. Default: false.
generate_audiobooleanWhether to generate audio for the video. - **true**: Generate with audio - **false**: Generate without audio Default: true.
resolutionstringVideo resolution - 480p for faster generation, 720p for balance, 1080p for High-quality video, 4K Ultra-High Definition, delivering perfect visual details. 4k output is 3840×2160 encoded as H.265 (HEVC); other resolutions are H.264. Make sure your player or pipeline supports HEVC. Allowed: 480p, 720p, 1080p, 4k. Default: 720p.
aspect_ratiostringVideo aspect ratio configuration. Required field. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive. Default: 16:9.
durationintegerVideo duration in 4-15 seconds or -1. Default: 5.
web_searchbooleanUse online search. Text-to-video only.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
bytedance/seedance-2-5 · Bytedance Seedance 2.5 · POST /v1/videos/generations
FieldTypeDetails
promptstringThe text prompt used to generate the video.. ( Max length: 20480 characters)
first_frame_urlstringFirst frame image url or asset://{assetId} (for example: asset://asset-20260404242101-76djj) Cannot be used simultaneously with reference_image_urls, reference_video_urls, or reference_audio_urls.
last_frame_urlstringEnd frame image url or asset://{assetId} (for example: asset://asset-20260404242101-76djj) last_frame_url cannot be passed alone; first_frame_url must be provided together with it.
reference_image_urlsarrayEnter a list of image URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj). Single image requirements: Format: jpeg, png, webp. Aspect ratio (width/height): (0.4, 2.5) Width and height (px): (300, 6000) Size: Single image less than 30 MB. Up to 30 images. Mutually exclusive with the first/last-frame scenario;
reference_video_urlsarrayEnter a list of video URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj) . Single video requirements: Video format: mp4, mov, mkv. Resolution: 480p, 720p Dimensions: Aspect ratio (width/height): [0.4, 2.5] Width/height (px): [300, 6000] Total pixels: [640×640=409600, 834×1112=927408], i.e., the product of width and height must meet the range requirement of [409600, 927408]
reference_audio_urlsarrayEnter a list of audio URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj) . Single audio requirements: Format: wav, mp3, aac, ogg Size: Single audio file size not exceeding 15 MB. Single audio duration: [2, 30] seconds; mutually exclusive with first/last frames; total duration of reference audio must not exceed 30 seconds.
return_last_framebooleanWhether to also return the last frame of the generated video as a JPEG (in resultJson.lastFrameUrl). Default false. Default: false.
generate_audiobooleanWhether to generate audio synchronized with the video. Default: true. Default: true.
resolutionstringVideo resolution - 480p for faster generation, 720p for balance. Allowed: 480p, 720p, 1080p. Default: 720p.
aspect_ratiostringVideo aspect ratio configuration. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive. Default: adaptive.
durationintegerVideo duration in 4-30 seconds. Special values -1: Pass -1 for automatic duration selection — the model picks a suitable duration itself (for video-editing tasks, it matches the input video's length; for other task types, it selects within the valid range), instead of you specifying an exact value. Default: 5.
output_formatstringVideo output format. Allowed: mp4, mov. Default: mp4.
web_searchbooleanEnable online search.
draftbooleanEnable draft mode. When enabled, only 480p resolution is allowed. Draft task ID is valid for 7 days from draft creation. Default: false.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
bytedance/seedance-2-5-draft · Bytedance Seedance 2.5 Draft · POST /v1/videos/generations
FieldTypeDetails
draft_task_id (required)stringtask id from model seedance 2.5 generation task. Valid for 7 days from draft creation.
resolution (required)stringoutput video resolution. Allowed: 1080p.
output_formatstringouput video format. Allowed: mp4, mov.
return_last_framebooleanWhether to also return the last frame of the generated video as a JPEG (in resultJson.lastFrameUrl). Default false. Default: false.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
bytedance/seedance-2-fast · Bytedance Seedance 2.0 Fast · POST /v1/videos/generations
FieldTypeDetails
promptstringThe text prompt used to generate the video. Required field. (Min length: 3, Max length: 20000 characters)
first_frame_urlstringFirst frame image url or asset://{assetId} (for example: asset://asset-20260404242101-76djj)
last_frame_urlstringEnd frame image url or asset://{assetId} (for example: asset://asset-20260404242101-76djj)
reference_image_urlsarrayEnter a list of image URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj). Single image requirements: Format: jpeg, png, webp, bmp, tiff, gif. Aspect ratio (width/height): (0.4, 2.5) Width and height (px): (300, 6000) Size: Single image less than 30 MB. Up to 9 images.
reference_video_urlsarrayEnter a list of video URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj). Single video requirements: Video format: mp4, mov. Resolution: 480p, 720p Duration: Single video duration [2, 15] s, maximum 3 reference videos, total duration of all videos not exceeding 15 seconds. Dimensions: Aspect ratio (width/height): [0.4, 2.5] Width/height (px): [300, 6000] Total pixels: [640
reference_audio_urlsarrayEnter a list of audio URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj). Single audio requirements: Format: wav, mp3 Duration: Single audio duration [2, 15] s, maximum 3 reference audios, total duration of all audios not exceeding 15 s. Size: Single audio file size not exceeding 15 MB.
return_last_framebooleanWhether to return the last frame of the video as an image. Default: false.
generate_audiobooleanWhether to generate audio for the video. - **true**: Generate with audio - **false**: Generate without audio Default: true.
resolutionstringVideo resolution - 480p for faster generation, 720p for balance Allowed: 480p, 720p. Default: 720p.
aspect_ratiostringVideo aspect ratio configuration. Required field. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive. Default: 16:9.
durationintegerVideo duration in 4-15 seconds or -1. Default: 5.
web_searchbooleanUse online search. Text-to-video only.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
bytedance/seedance-2-mini · Bytedance Seedance 2.0 Mini · POST /v1/videos/generations
FieldTypeDetails
promptstringThe text prompt used to generate the video. Required field. (Min length: 3, Max length: 20000 characters)
first_frame_urlstringFirst frame image url or asset://{assetId} (for example: asset://asset-20260404242101-76djj)
last_frame_urlstringEnd frame image url or asset://{assetId} (for example: asset://asset-20260404242101-76djj)
reference_image_urlsarrayEnter a list of image URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj). Single image requirements: Format: jpeg, png, webp, gif. Aspect ratio (width/height): (0.4, 2.5) Width and height (px): (300, 6000) Size: Single image less than 30 MB. Up to 9 images.
reference_video_urlsarrayEnter a list of video URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj). Single video requirements: Video format: mp4, mov. Resolution: 480p, 720p Duration: Single video duration [2, 15] s, maximum 3 reference videos, total duration of all videos not exceeding 15 seconds. Dimensions: Aspect ratio (width/height): [0.4, 2.5] Width/height (px): [300, 6000] Total pixels: [640
reference_audio_urlsarrayEnter a list of audio URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj). Single audio requirements: Format: wav, mp3 Duration: Single audio duration [2, 15] s, maximum 3 reference audios, total duration of all audios not exceeding 15 s. Size: Single audio file size not exceeding 15 MB.
generate_audiobooleanWhether to generate audio for the video. - **true**: Generate with audio - **false**: Generate without audio Default: true.
resolutionstringVideo resolution - 480p for faster generation, 720p for balance Allowed: 480p, 720p. Default: 720p.
aspect_ratiostringVideo aspect ratio configuration. Required field. Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive. Default: 16:9.
durationintegerVideo duration in 4-15 seconds or -1. Default: 5.
web_searchbooleanUse online search. Text-to-video only.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
bytedance/v1-lite-image-to-video · Bytedance - V1 Lite Image to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt used to generate the video (Max length: 10000 characters)
image_url (required)stringThe URL of the image used to generate video (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
resolutionstringVideo resolution - 480p for faster generation, 720p for higher quality Allowed: 480p, 720p, 1080p. Default: 720p.
durationstringDuration of the video in seconds Allowed: 5, 10. Default: 5.
camera_fixedbooleanWhether to fix the camera position (Boolean value (true/false))
seednumberRandom seed to control video generation. Use -1 for random. (Min: -1, Max: 2147483647, Step: 1) (step: 1) Default: -1.
enable_safety_checkerbooleanThe safety checker is always enabled in Playground. It can only be disabled by setting false through the API. (Boolean value (true/false))
end_image_urlstringThe URL of the image the video ends with. Defaults to None. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
bytedance/v1-lite-text-to-video · Bytedance - V1 Lite Text to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt used to generate the video (Max length: 10000 characters)
aspect_ratiostringThe aspect ratio of the generated video Allowed: 16:9, 4:3, 1:1, 3:4, 9:16, 9:21. Default: 16:9.
resolutionstringVideo resolution - 480p for faster generation, 720p for higher quality Allowed: 480p, 720p, 1080p. Default: 720p.
durationstringDuration of the video in seconds Allowed: 5, 10. Default: 5.
camera_fixedbooleanWhether to fix the camera position (Boolean value (true/false))
seedintegerRandom seed to control video generation. Use -1 for random.
enable_safety_checkerbooleanThe safety checker is always enabled in Playground. It can only be disabled by setting false through the API. (Boolean value (true/false))
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
bytedance/v1-pro-fast-image-to-video · Bytedance V1 Pro Fast Image to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt used to generate the video (Max length: 10000 characters)
image_url (required)stringThe URL of the image used to generate video (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
resolutionstringOutput resolution: 720p or 1080p. Allowed: 720p, 1080p. Default: 720p.
durationstringDuration of the video in seconds Allowed: 5, 10. Default: 5.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
bytedance/v1-pro-image-to-video · Bytedance V1 Pro Image to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt used to generate the video (Max length: 10000 characters)
image_url (required)stringThe URL of the image used to generate video (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
resolutionstringVideo resolution - 480p for faster generation, 720p for balance, 1080p for higher quality Allowed: 480p, 720p, 1080p. Default: 720p.
durationstringDuration of the video in seconds Allowed: 5, 10. Default: 5.
camera_fixedbooleanWhether to fix the camera position (Boolean value (true/false))
seednumberRandom seed to control video generation. Use -1 for random. (Min: -1, Max: 2147483647, Step: 1) (step: 1) Default: -1.
enable_safety_checkerbooleanThe safety checker is always enabled in Playground. It can only be disabled by setting false through the API. (Boolean value (true/false))
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
bytedance/v1-pro-text-to-video · Bytedance - V1 Pro Text to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt used to generate the video (Max length: 10000 characters)
aspect_ratiostringThe aspect ratio of the generated video Allowed: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Default: 16:9.
resolutionstringVideo resolution - 480p for faster generation, 720p for balance, 1080p for higher quality Allowed: 480p, 720p, 1080p. Default: 720p.
durationstringDuration of the video in seconds Allowed: 5, 10. Default: 5.
camera_fixedbooleanWhether to fix the camera position (Boolean value (true/false))
seednumberRandom seed to control video generation. Use -1 for random. (Min: -1, Max: 2147483647, Step: 1) (step: 1) Default: -1.
enable_safety_checkerbooleanThe safety checker is always enabled in Playground. It can only be disabled by setting false through the API. (Boolean value (true/false))
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
gemini-omni-video · Gemini Omni Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringVideo prompt used to describe the target content, style, camera language, or character actions in the generated video.
image_urlsarrayArray of image URLs. You can provide one or more reference images for characters, scenes, styles, or storyboard guidance. Image limits: - Each file must be no larger than `20MB` - Use publicly accessible image URLs - Max 7 images
audio_idsarrayArray of audio IDs generated by the `gemini-omni-audio` endpoint. Useful for narration, dialogue, music, or audio guidance in the generated video. Max 3 items.
video_listarrayArray of video clips. Each item defines a source video and the trim range to use during generation. Video limits: - Each file must be no larger than `100MB` - Video duration must not exceed `30s` - `ends` should be greater than `start` - The difference between the end time and the start time must not exceed `10s`. - Max 1 items. Equal 2 images
character_idsarrayAn array of character IDs generated by the `gemini-omni-character` API. Used to provide character appearance, identity, or person references for the video. Up to 3 character IDs. Each uses 1 image slot (2 if created with portrait + body images). Total slots (images + videos × 2 + character slots) ≤ 7.
duration (required)stringThe duration of the generated video in seconds. Available values are 4, 6, 8, and 10. When video input is provided, the output duration is determined by the model automatically. This duration parameter will not take effect.Note: when video input is provided, the output duration is determined by the model automatically. This duration parameter will not take effect. Allowed: 4, 6, 8, 10.
aspect_ratiostringThe aspect ratio of the generated video. `16:9` is landscape, and `9:16` is portrait. Allowed: 16:9, 9:16.
resolutionstringThe resolution of the generated video. Available values are 720p, 1080p, and 4k. Allowed: 720p, 1080p, 4k. Default: 720p.
seedintegerRandom seed. Range: [0, 2147483647]. If not specified, the system generates a seed automatically. Fixing the seed can improve reproducibility, but results may still vary due to the model’s stochasticity.
google/gemini-omni-flash-1-1 · Gemini Omni 1.1 Flash · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe video prompt, used to describe the visual content, style, cinematography, or character actions of the target video.
image_urlsarrayAn array of image URLs. Multiple reference images can be uploaded to provide references for characters, scenes, styles, or storyboards. Image limitations: - Each file must not exceed `20MB` - Use publicly accessible image URLs - Maximum of 7 images - Note: This field is mutually exclusive with the first-frame image (`first_frame_url`) and cannot be provided at the same time.
first_frame_urlstringThe URL of the first-frame image. Used to specify the starting frame of the generated video. Note: This field is mutually exclusive with `image_urls`, `audio_ids`, `video_list`, and `character_ids` and cannot be provided at the same time.
last_frame_urlstringThe URL of the last-frame image. Used to specify the ending frame of the generated video. Note: The last-frame image cannot be used alone and must be provided together with the first-frame image (`first_frame_url`).
audio_idsarrayAn array of audio IDs generated by the `gemini-omni-audio` interface. Used to provide narration, dialogue, background music, or sound references for the video. Up to 3 items. Note: This field is mutually exclusive with the first-frame image (`first_frame_url`) and cannot be provided at the same time.
video_listarrayAn array of video clips. Each element describes a video asset that can be used for generation and its trimming time range. Video limitations: - Each file must not exceed `100MB` - Video duration must not exceed `30s` - `ends` should be greater than `start` - The difference between the end and start times must not exceed `10s` - Maximum of 1 item, occupying two image slots - Note: This field is mut
character_idsarrayAn array of character IDs generated by the `gemini-omni-character` interface. Used to provide character appearance, identity, or person references for the video. Up to 3 character IDs. Each uses 1 image slot (2 if created with portrait + body images). Total slots (images + videos × 2 + character slots) ≤ 7. Note: This field is mutually exclusive with the first-frame image (`first_frame_url`) and c
duration (required)stringThe duration of the generated video, in seconds. Valid values are 4, 6, 8, and 10. This parameter only takes effect when there is no video input. If video input is used, the output duration is determined by the model, and the `duration` parameter will be ignored. Note: When video input is provided, the output duration is automatically determined by the model. In this case, the `duration` parameter Allowed: 4, 6, 8, 10.
aspect_ratiostringThe aspect ratio of the generated video. `16:9` is landscape, and `9:16` is portrait. Allowed: 16:9, 9:16.
resolutionstringThe resolution of the generated video. Valid values are 360p, 720p, 1080p, and 4k. Allowed: 360p, 720p, 1080p, 4k. Default: 720p.
seedintegerThe random seed. Valid range: [0, 2147483647]. If not specified, the system will automatically generate a seed. A fixed seed can improve result reproducibility, but because the model itself is stochastic, results may still vary.
grok-imagine-video-1-5-preview · Grok Imagine Video 1.5 Preview · POST /v1/videos/generations
FieldTypeDetails
promptstringPrompt for video generation. Maximum length: 4096 characters.
image_urlsarrayUpload image files to be used as API input. Supported file types: image/jpeg, image/png, image/webp, image/jpg. Maximum file size: 20MB. Supports multi-file upload, up to 7 file.Only one is supported when the resolution is 1080p.
aspect_ratiostringThe aspect ratio of the video. This parameter is invalid if it is a single image. Allowed: 1:1, 16:9, 9:16, 3:2, 2:3, auto. Default: auto.
resolutionstringResolution for video generation. Allowed: 480p, 720p, 1080p. Default: 480p.
durationintegerVideo duration in seconds. Range: [1, 15]. Default: 8. Minimum: 1. Maximum: 15. Step: 1. Default: 8.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
grok-imagine/extend · Grok Imagine - Video Extend · POST /v1/videos/generations
FieldTypeDetails
task_id (required)stringTask ID from a previously successful video generation task. Required field. - task_id must be a successful grok-imagine/text-to-video or grok-imagine/image-to-video task. - The original video generation must have completed successfully - Only Omni AI–generated task IDs are supported
prompt (required)stringText instructions describing the required movement of the video. Required field. - Provide a detailed description of how you would like the video to expand and continue. - You can specify camera movements, scene changes, object actions, etc. - The more specific the prompt words are, the more likely the generated effect will match your expectations. - Supports input in both Chinese and English.
extend_at (required)numberRequired. Time point in the source video, in seconds (minimum 2), from which the extension starts. Default: 2.
extend_times (required)string6 or 10 (seconds). Allowed: 6, 10.
grok-imagine/image-to-video · Grok Imagine Image to Video · POST /v1/videos/generations
FieldTypeDetails
image_urlsarrayProvide an external image URL as a reference for video generation. Up to 7 images are supported. Do not use it simultaneously with task_id. In your prompt, reference an uploaded image by typing @image(n) followed by a space (for example: @image1 a sunset over the ocean). - Supports JPEG, PNG, and WEBP formats - Maximum file size for each image: 10MB - The Spicy mode is not available when using ext
task_idstringTask ID from a previously generated Grok image. Use with index to select a specific image. Do not use with image_urls. - Use task ID from grok-imagine/text-to-image generations - Supports all modes including Spicy - Maximum length: 100 characters
indexintegerWhen using task_id, the 0-based index of the image to use. A grok-imagine/text-to-image task returns 2 images, so valid values are 0 and 1. Default 0. - Ignored if image_urls is provided Default: 0.
promptstringText prompt describing the desired video motion. Optional field. - Should be detailed and specific about the desired visual motion - Describe movement, action sequences, camera work, and timing - Include details about subjects, environments, and motion dynamics - Maximum length: 5000 characters - Supports English language prompts
modestringSpecifies the generation mode affecting the style and intensity of motion. Note: Spicy mode is not available for external image inputs. - **fun**: More creative and playful interpretation - **normal**: Balanced approach with good motion quality - **spicy**: More dynamic and intense motion effects (not available for external images) Default: normal Allowed: fun, normal, spicy. Default: normal.
durationstringThe duration of the generated video (in seconds) (6-30). (Minimum: 6, Maximum: 30, Step: 1)
resolutionstringThe resolution of the generated video. Allowed: 480p, 720p, 1080p. Default: 480p.
aspect_ratiostringImage ratio selection only applies to multi-image generation mode. In single-image mode, the video width and height are referenced to the image width and height. Allowed: 2:3, 3:2, 1:1, 16:9, 9:16. Default: 16:9.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
grok-imagine/text-to-video · Grok Imagine Text to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompt describing the desired video motion. Required field. - Should be detailed and specific about the desired visual motion - Describe movement, action sequences, camera work, and timing - Include details about subjects, environments, and motion dynamics - Maximum length: 5000 characters - Supports English language prompts
aspect_ratiostringSpecifies the width-to-height ratio of the generated video. Controls the aspect ratio of the output. - **2:3**: Portrait orientation (vertical) - **3:2**: Landscape orientation (horizontal) - **1:1**: Square format - **16:9**: Wide screen format - **9:16**: Tall screen format Default: 2:3 Allowed: 2:3, 3:2, 1:1, 16:9, 9:16. Default: 2:3.
modestringSpecifies the generation mode affecting the style and intensity of motion. - **fun**: More creative and playful interpretation - **normal**: Balanced approach with good motion quality - **spicy**: More dynamic and intense motion effects Default: normal Allowed: fun, normal, spicy. Default: normal.
durationnumberThe duration of the generated video (in seconds) (6-30). (Minimum: 6, Maximum: 30, Step: 1)
resolutionstringThe resolution of the generated video. Allowed: 480p, 720p, 1080p. Default: 480p.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
hailuo/02-image-to-video-pro · Hailuo Pro Image to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompt describing the desired video animation (Max length: 1500 characters)
image_url (required)stringInput image to animate (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
end_image_urlstringOptional URL of the image to use as the last frame of the video (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
prompt_optimizerbooleanWhether to use the model's prompt optimizer (Boolean value (true/false))
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
hailuo/02-image-to-video-standard · Hailuo Standard Image to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt describing the video to generate (Max length: 1500 characters)
image_url (required)stringThe URL of the image to use as the first frame of the video (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
end_image_urlstringOptional URL of the image to use as the last frame of the video (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
duration (required)stringRequired. Video duration in seconds: 6 or 10. Allowed: 6, 10.
resolution (required)stringRequired. The resolution of the generated video. Allowed: 512P, 768P.
prompt_optimizerbooleanWhether to use the model's prompt optimizer (Boolean value (true/false))
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
hailuo/02-text-to-video-pro · Hailuo Pro Text to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt for video generation (Max length: 1500 characters)
prompt_optimizerbooleanWhether to use the model's prompt optimizer (Boolean value (true/false))
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
hailuo/02-text-to-video-standard · Hailuo Standard Text to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText description for video generation (Max length: 1500 characters)
duration (required)stringRequired. Video duration in seconds: 6 or 10. Allowed: 6, 10.
prompt_optimizerbooleanWhether to use the model's prompt optimizer (Boolean value (true/false))
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
hailuo/2-3-image-to-video-pro · Hailuo 2.3 Pro Image to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompt describing the desired video animation (Max length: 5000 characters)
image_url (required)stringInput image to animate (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
duration (required)stringRequired. The duration of the video in seconds. 10 seconds videos are not supported for 1080p resolution. Allowed: 6, 10.
resolution (required)stringRequired. The resolution of the generated video. Allowed: 768P, 1080P.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
hailuo/2-3-image-to-video-standard · Hailuo 2.3 Standard Image to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompt describing the desired video animation (Max length: 5000 characters)
image_url (required)stringInput image to animate (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
duration (required)stringRequired. The duration of the video in seconds. 10 seconds videos are not supported for 1080p resolution. Allowed: 6, 10.
resolution (required)stringRequired. The resolution of the generated video. Allowed: 768P, 1080P.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
happyhorse-1-1/image-to-video · HappyHorse-1-1 image-to-video · POST /v1/videos/generations
FieldTypeDetails
promptstringDescribes the video content to generate. Supports any language. Maximum: 5,000 non-Chinese characters or 2,500 Chinese Default: .
image_urls (required)arrayThe URL of the first frame image. Image constraints: 1. Formats: JPEG, JPG, PNG, WEBP. 2. Resolution: Width and height must both be at least 300 pixels. 3. Aspect ratio: Between 1:2.5 and 2.5:1. 4. File size: Up to 20 MB.
resolutionstringThe resolution of the generated video. Options: 720p; 1080p The output keeps the aspect ratio of the input image; 720p / 1080p set the resolution tier. Allowed: 720p, 1080p. Default: 1080p.
durationnumberThe duration of the generated video, in seconds. The value must be an integer in the range [3, 15]. Default: 5 Default: 5.
happyhorse-1-1/reference-to-video · HappyHorse-1-1 reference-to-video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringA description of the desired elements and visual style for the generated video. Input in any language is supported. Up to 5,000 characters. Use "[Image 1]", "[Image 2]" to refer to the images in reference_image, in the same order. When using a reference, specify the object in the image, such as "the woman in a red qipao in [Image 1]".
reference_image (required)arrayThe URL of a reference image. Image requirements: 1. Formats: JPEG, JPG, PNG, WEBP. 2. Resolution: The shortest side must be at least 400 pixels. A clear image with a resolution of 720P or higher is recommended. Avoid using images that are too small, blurry, or overly compressed, as this can degrade the output quality. 3. Maximum file size: 20 MB.
resolutionstringThe resolution tier of the generated video. Options: 720p; 1080p Allowed: 720p, 1080p. Default: 1080p.
aspect_ratiostringThe aspect ratio of the generated video. Options: 16:9; 9:16; 3:4; 4:3; 4:5; 5:4; 1:1; 9:21; 21:9 Allowed: 16:9, 9:16, 3:4, 4:3, 4:5, 5:4, 1:1, 9:21, 21:9. Default: 16:9.
durationnumberThe duration of the generated video, in seconds. Value range: An integer from 3 to 15. Default: 5.
happyhorse-1-1/text-to-video · HappyHorse-1-1 text-to-video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText description of the video to generate. Supports any language. Maximum 5,000 non-Chinese characters or 2,500 Chinese
resolutionstringOutput video resolution. Options: 720p; 1080p Allowed: 720p, 1080p. Default: 1080p.
aspect_ratiostringOutput video aspect ratio. Options: 16:9; 9:16; 1:1; 4:3; 3:4; 4:5; 5:4; 9:21; 21:9 Allowed: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9. Default: 16:9.
durationnumberOutput video duration in seconds. Integer, 3–15. Default 5. Default: 5.
happyhorse/image-to-video · happyhorse-image-to-video · POST /v1/videos/generations
FieldTypeDetails
promptstringText prompt describing the video to generate (any language). Up to 5,000 characters.
image_urls (required)arrayFirst-frame image URL list. Exactly one image is required. Image constraints: Format: JPEG, JPG, PNG, WEBP. Resolution: Width and height must be at least 300 pixels. Aspect ratio: 1:2.5 to 2.5:1. File size: Up to 10 MB.
resolutionstringOutput video resolution: 720p or 1080p (default). The output keeps the aspect ratio of the input image; 720p / 1080p set the resolution tier. Allowed: 720p, 1080p. Default: 1080p.
durationintegerOutput duration in seconds. Must be between 3 and 15. Defaults to 5. Default: 5.
seedintegerRandom seed for reproducibility. Default: 0.
happyhorse/reference-to-video · happyhorse/reference-to-video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompt describing the video to generate (any language). Up to 5,000 characters.
reference_image (required)arrayReference image URL list. Provide 1–9 images. The order defines which image is character1, character2, etc. Image limits: Format: JPEG, JPG, PNG, and WEBP. Resolution: shortest side at least 400 px. 720P or higher recommended. Avoid small, blurry, or heavily compressed images, as they degrade output quality. File size: 10 MB maximum.
resolutionstringOutput video resolution: 720p or 1080p (default). Allowed: 720p, 1080p. Default: 1080p.
aspect_ratiostringOutput aspect ratio. Valid values: 16:9 (default), 9:16, 1:1, 4:3, 3:4. Allowed: 16:9, 9:16, 1:1, 4:3, 3:4. Default: 16:9.
durationintegerOutput duration in seconds (integer). Must be between 3 and 15. Defaults to 5. Default: 5.
seedintegerRandom seed for reproducibility. Default: 0.
happyhorse/text-to-video · happyhorse-text-to-video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompt describing the video to generate (any language). Up to 5,000 characters.
resolutionstringOutput video resolution: 720p or 1080p (default). Allowed: 720p, 1080p. Default: 1080p.
aspect_ratiostringOutput aspect ratio. Valid values: 16:9 (default), 9:16, 1:1, 4:3, 3:4. Allowed: 16:9, 9:16, 1:1, 4:3, 3:4. Default: 16:9.
durationintegerOutput duration in seconds (integer). Must be between 3 and 15. Defaults to 5. Default: 5.
seedintegerRandom seed for reproducibility. Default: 0.
happyhorse/video-edit · happyhorse/video-edit · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringRequired edit instruction describing the intended change (e.g., style transfer / local replacement). Up to 5,000 characters.
video_url (required)stringURL of the input video (one video). Video requirements: Format: MP4, MOV (H.264 encoding recommended). Duration: 3–60 seconds. Resolution: the longer side must not exceed 2,160 px; the shorter side must be at least 320 px. Aspect ratio: 1:2.5–2.5:1. File size: up to 100 MB. Frame rate: greater than 8 fps.
reference_imagearrayOptional reference image URL list (0–5). Image requirements: Format: JPEG, JPG, PNG, WEBP. Resolution: both width and height must be at least 300 px. Aspect ratio: 1:2.5–2.5:1. File size: up to 10 MB.
resolutionstringOutput video resolution: 720p or 1080p (default). Allowed: 720p, 1080p. Default: 1080p.
audio_settingstringAudio handling: auto lets the model handle audio; origin keeps the input video's original audio where possible. Allowed: auto, origin. Default: auto.
seedintegerRandom seed for reproducibility. Default: 0.
kling-2.6/image-to-video · Kling 2.6 Image to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompt (max 2,500 characters).
image_urls (required)arrayImage URLs for video generation. (Uploaded file URLs, not file content; supported types: image/jpeg, image/png; maximum file size: 10.0MB)
sound (required)booleanRequired. This parameter specifies whether the generated video contains sound (boolean: true/false)
duration (required)stringRequired. Video duration (unit: seconds) Allowed: 5, 10.
kling-2.6/motion-control · Kling 2.6 motion-control · POST /v1/videos/generations
FieldTypeDetails
promptstringA text description of the desired output. Maximum length is 2500 characters. (Max length: 2500 characters)
input_urls (required)arrayAn array containing a single image URL. The photo must clearly show the subject's head, shoulders, and torso. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/jpg; Max size: 10.0MB,size needs to be greater than 300px, aspect ratio 2:5 to 5:2.)
video_urls (required)arrayAn array containing a single video URL. The duration must be between 3 to 30 seconds, and the video must clearly show the subject's head, shoulders, and torso. (File URL after upload, not file content; Accepted types: video/mp4, video/quicktime; Max size: 100.0MB)
character_orientation (required)stringRequired. Generate the orientation of the characters in the video. 'image': same orientation as the person in the picture (max 10s video). 'video': consistent with the orientation of the characters in the video (max 30s video). Allowed: image, video.
mode (required)stringRequired. Output resolution: "720p" or "1080p". Allowed: 720p, 1080p.
kling-2.6/text-to-video · Kling 2.6 Text to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompt (max 2,500 characters).
sound (required)booleanRequired. This parameter specifies whether the generated video contains sound (boolean: true/false)
aspect_ratio (required)stringRequired. This parameter defines the video aspect ratio Allowed: 1:1, 16:9, 9:16.
duration (required)stringRequired. Video duration (unit: seconds) Allowed: 5, 10.
kling-3.0-omni/image-to-video · Kling 3.0 Omni Image To Video · POST /v1/videos/generations

No input fields beyond the prompt.

kling-3.0-omni/reference-to-video · Kling 3.0 Omni Reference To Video · POST /v1/videos/generations

No input fields beyond the prompt.

kling-3.0-omni/text-to-video · Kling 3.0 Omni Text to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText description of the video. It must not be empty after leading and trailing whitespace is removed, and must not exceed 3,072 characters.
customize_multi_shotsbooleanOptional, default false. Set true for custom multi-shot (multi_prompt required). Default: false.
prefer_multi_shotsbooleanWhether to enable intelligent shot planning. This field is mutually exclusive with `customize_multi_shots`. Both fields may be `false`, but they cannot both be `true`.
multi_promptarrayList of custom shots. When `customize_multi_shots` is `true`, this field is required, must not be empty, and supports up to 6 shots. When `customize_multi_shots` is `false`, it must be an empty array or omitted.
elementsarrayList of one-time subject assets. The default is an empty array. When using only multi-image subjects, up to 7 subjects can be uploaded. When using only video character subjects, the number of video character subjects must not exceed 3. When using both video character and multi-image subjects, the number of video character subjects must not exceed 3, and the number of multi-image subjects must not
audiobooleanWhether to add audio to the generated video. `true` enables audio; `false` disables audio. Default: false.
resolutionstringResolution of the generated video. Available values are `720p` (outputs a 720p video), `1080p` (outputs a 1080p video), and `4k` (outputs a 4K video). Allowed: 720p, 1080p, 4k. Default: 720p.
aspect_ratiostringAspect ratio of the generated video. Supported values are `16:9`, `9:16`, and `1:1`. Allowed: 16:9, 9:16, 1:1. Default: 16:9.
durationintegerTotal video duration in seconds. The supported range is 3 to 15 seconds, and the default is 5 seconds. Allowed: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15. Default: 5.
kling-3.0-omni/transformation · Kling 3.0 Omni Transformation · POST /v1/videos/generations
FieldTypeDetails
promptstringVideo description. It must not be empty after leading and trailing whitespace is removed. Maximum length: 3,072 characters.
video_urlsarrayArray of video URLs. Exactly 1 video is required. HTTP, HTTPS, and OSS URLs are supported. Videos must be in MP4 or MOV format; each file must not exceed 200 MB; duration must be between 3 and 15.5 seconds; width and height must each be between 700 and 4,553 px; total pixels must not exceed 8,294,400; the aspect ratio must be between 0.4 and 2; and the frame rate must be between 24 and 60 fps.
image_urlsarrayArray of image URLs. The maximum number of images depends on the number and types of reference subjects. When using only multi-image subjects, the combined number of reference images and multi-image subjects must not exceed 4. Video character subjects cannot be used together with multi-image subjects or reference images. HTTP, HTTPS, and OSS URLs are supported. Images must be in JPG, JPEG, or PNG
durationstringVideo duration. This field may be configured when using a video with images.
resolutionstringVideo resolution. `720p` outputs a 720p video, `1080p` outputs a 1080p video, and `4k` outputs a 4K video. Allowed: 720p, 1080p, 4k. Default: 720p.
aspect_ratiostringVideo aspect ratio. Only `auto` can be used with video-only input. When using a video with images, `16:9`, `9:16`, and `1:1` are supported; `auto` is not supported. Allowed: 16:9, 9:16, 1:1, auto. Default: 16:9.
audiobooleanNo audio is generated when a video is provided; set false. Allowed: false, true.
elementsarrayList of one-time subject assets. The default is an empty array. When using only multi-image subjects, up to 7 subjects can be uploaded. When using only video character subjects, the number of video character subjects must not exceed 3. When using both video character and multi-image subjects, the number of video character subjects must not exceed 3, and the number of multi-image subjects must not
kling-3.0/motion-control · Kling-3.0 motion-control · POST /v1/videos/generations
FieldTypeDetails
promptstring(Optional) Text prompt words, used to guide the generation of animation content. Can be empty or 0 - 2500 characters long.
input_urls (required)array(Required) Include a URL of an image
video_urls (required)array(Required) Include a video URL
modestringOptional. Output resolution: "720p" (default) or "1080p". Allowed: 720p, 1080p. Default: 720p.
character_orientationstring(Optional) Reference source for character orientation. video: Refer to video (recommended); image: Refer to image. Default value: video
kling-3.0/video · Kling 3.0 · POST /v1/videos/generations
FieldTypeDetails
promptstringRequired when multi_shots is false. Up to 2,500 characters.
image_urlsarrayFirst and last frame image URLs. Optional; not required when using kling_elements. When multi_shots is false: if length is 2, index 0 is the first frame and index 1 is the last frame; if length is 1, the array item serves as the first frame. When multi_shots is true: only the first frame is supported.
sound (required)booleanRequired. Whether to generate audio (speech, sound effects, ambience) with the video. Affects price.
duration (required)stringRequired. Video duration in seconds, 3–15 (string, e.g. "5"). In multi-shot mode, output length and billing follow the sum of multi_prompt[].duration (3–15 s); set duration to the same total. Allowed: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.
aspect_ratiostringOptional when image_urls is provided (the output follows the first frame's aspect ratio). For text-to-video, set it explicitly: 16:9, 9:16 or 1:1. Allowed: 16:9, 9:16, 1:1.
mode (required)stringRequired. Generation mode. std has standard resolution, pro has higher resolution, 4K has 4K resolution. Resolution mapping: - **std mode**: 16:9 (1280×720), 9:16 (720×1280), 1:1 (720×720) - **pro mode**: 16:9 (1920×1080), 9:16 (1080×1920), 1:1 (1080×1080) - **4K mode**: 16:9 (3840×2160), 9:16 (2160×3840), 1:1 (2160×2160) Allowed: std, pro, 4K.
multi_shots (required)booleanRequired. Whether to use multi-shot mode. true enables multi-shot mode, false enables single-shot mode.
multi_promptarrayShot prompts. Takes effect when multi_shots is true. Used to describe the text and duration of each shot. Supports up to 5 shots. Each shot duration is 1-12 seconds. If you need to use elements, add them after the prompt.
kling_elementsarrayReferenced elements. Detailed information about elements referenced in the prompt. A single task can reference a maximum of three elements.
kling/v2-1-master-image-to-video · Kling V2.1 Master Image to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt describing the video to generate (Max length: 5000 characters)
image_url (required)stringURL of the image to be used for the video (File URL after upload, not file content; Accepted types: image/jpeg, image/png; Max size: 10.0MB)
duration (required)stringRequired. "5" or "10" (seconds). Allowed: 5, 10.
negative_promptstringNegative prompt to exclude certain elements from the video (Max length: 500 characters)
cfg_scalenumberThe CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt (Min: 0, Max: 1, Step: 0.1) (step: 0.1) Default: 0.5.
kling/v2-1-master-text-to-video · Kling V2.1 Master Text to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt describing the video you want to generate (Max length: 5000 characters)
duration (required)stringRequired. "5" or "10" (seconds). Allowed: 5, 10.
aspect_ratiostringThe aspect ratio of the generated video frame Allowed: 16:9, 9:16, 1:1. Default: 16:9.
negative_promptstringElements to avoid in the generated video (Max length: 500 characters)
cfg_scalenumberThe CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt (Min: 0, Max: 1, Step: 0.1) (step: 0.1) Default: 0.5.
kling/v2-1-pro · Kling V2.1 Pro · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompt describing the video to generate (Max length: 5000 characters)
image_url (required)stringURL of the image to be used for the video (File URL after upload, not file content; Accepted types: image/jpeg, image/png; Max size: 10.0MB)
duration (required)stringRequired. "5" or "10" (seconds). Allowed: 5, 10.
negative_promptstringTerms to avoid in the generated video (Max length: 500 characters)
cfg_scalenumberThe CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt (Min: 0, Max: 1, Step: 0.1) (step: 0.1) Default: 0.5.
tail_image_urlstringURL of the image to be used for the end of the video (File URL after upload, not file content; Accepted types: image/jpeg, image/png; Max size: 10.0MB)
kling/v2-1-standard · Kling V2.1 Standard · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompt describing the desired video content (Max length: 5000 characters)
image_url (required)stringURL of the image to be used for the video (File URL after upload, not file content; Accepted types: image/jpeg, image/png; Max size: 10.0MB)
duration (required)stringRequired. "5" or "10" (seconds). Allowed: 5, 10.
negative_promptstringDescription of elements to avoid in the generated video (Max length: 500 characters)
cfg_scalenumberThe CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt (Min: 0, Max: 1, Step: 0.1) (step: 0.1) Default: 0.5.
kling/v2-5-turbo-image-to-video-pro · Kling - V2.5 Turbo Image to Video Pro · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt describing the video to generate (Max length: 2500 characters)
image_url (required)stringURL of the image to be used for the video (File URL after upload, not file content; Accepted types: image/jpeg, image/png; Max size: 10.0MB)
tail_image_urlstringTail frame image of video (File URL after upload, not file content; Accepted types: image/jpeg, image/png; Max size: 10.0MB)
duration (required)stringRequired. "5" or "10" (seconds). Allowed: 5, 10.
negative_promptstringNegative prompt to exclude certain elements from the video (Max length: 2,496 characters)
cfg_scalenumberThe CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt (Min: 0, Max: 1, Step: 0.1) (step: 0.1) Default: 0.5.
kling/v2-5-turbo-text-to-video-pro · Kling - V2.5 Turbo Text to Video Pro · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text description of the video you want to generate (Max length: 2500 characters)
duration (required)stringRequired. "5" or "10" (seconds). Allowed: 5, 10.
aspect_ratiostringThe aspect ratio of the generated video frame Allowed: 16:9, 9:16, 1:1. Default: 16:9.
negative_promptstringThings to avoid in the generated video (Max length: 2500 characters)
cfg_scalenumberThe CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt (Min: 0, Max: 1, Step: 0.1) (step: 0.1) Default: 0.5.
kling/v3-turbo-image-to-video · Kling - V3 Turbo Image to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt describing the video to generate (Max length: 2500 characters)
image_urls (required)arrayRequired. URL of the image to be used for the video (File URL after upload, not file content; Accepted types: image/jpeg, image/png; Max size: 10.0MB)
duration (required)stringRequired. The duration of the generated video in seconds Optional duration: 3s - 15s
resolution (required)stringRequired. Resolution of the generated video (720p or 1080p) Allowed: 720p, 1080p.
kling/v3-turbo-text-to-video · Kling - V3 Turbo Text to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text description of the video you want to generate (Max length: 2500 characters)
duration (required)stringRequired. The duration of the generated video in seconds Optional duration: 3s - 15s
aspect_ratio (required)stringRequired. The aspect ratio of the generated video frame Allowed: 1:1, 9:16, 16:9.
resolution (required)stringRequired. Resolution of the generated video (720p or 1080p) Allowed: 720p, 1080p.
minimax-h3/image-to-video · MiniMax H3 Image-to-Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringVideo generation prompt, length is between 1 and 7000 characters.
first_frame_urlstringFirst frame image URL. Note: Either first_frame_url or last_frame_url must be provided. Publicly accessible HTTP(S) URL; supports JPG, JPEG, PNG, WEBP, HEIC, HEIF formats; single image size not exceeding 30 MB, image side length between 256 and 5760 pixels, aspect ratio between 0.4 and 2.5.
last_frame_urlstringLast frame image URL. Note: Either first_frame_url or last_frame_url must be provided. Image restrictions are the same as first_frame_url.
duration (required)integerGenerated video duration, supporting integer values from 4 to 15 seconds. Allowed: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15. Default: 6.
resolutionstringVideo resolution. Allowed: 768P, 2K. Default: 2K.
minimax-h3/reference-to-video · MiniMax H3 Reference-to-Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringVideo generation prompt, length is between 1 and 7000 characters.
reference_image_urlsarrayArray of reference image URLs. Supports up to 9 images. Publicly accessible HTTP(S) URL; supported image formats include JPG, JPEG, PNG, WEBP, HEIC, and HEIF; a single image size cannot exceed 30 MB; the side length of the image must be between 256 and 5760 pixels, and the aspect ratio must be between 0.4 and 2.5. Provide at least one of reference_image_urls or reference_video_urls.
reference_video_urlsarrayArray of reference video URLs. Supports up to 3 videos. Supports MP4, MOV; video encoding supports H.264, H.265; a single file size cannot exceed 50 MB; the duration of a single segment is 2 to 15 seconds, and the total duration of all reference videos cannot exceed 15 seconds; the video side length must be between 256 and 5760 pixels, the aspect ratio must be between 0.4 and 2.5, and the frame ra
reference_audio_urlsarrayArray of reference audio URLs. Supports up to 3 audios. Supports WAV, MP3; a single file size cannot exceed 15 MB; the duration of a single segment is 2 to 15 seconds, and the total duration of all reference audios cannot exceed 15 seconds. reference_audio cannot be used alone, it must be accompanied by reference_image or reference_video.
aspect_ratiostringVideo aspect ratio. The default is adaptive, or a specific ratio can be specified. Allowed: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Default: adaptive.
duration (required)integerThe duration of the generated video, supporting integer values from 4 to 15 seconds. Allowed: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15. Default: 6.
resolutionstringVideo resolution. Allowed: 768P, 2K. Default: 2K.
minimax-h3/text-to-video · MiniMax H3 Text-to-Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringVideo generation prompt, length is between 1 and 7000 characters.
aspect_ratio (required)stringVideo aspect ratio. Required for text-to-video, adaptive is not supported. Allowed: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
duration (required)integerGenerated video duration, supports integer values from 4 to 15 seconds. Allowed: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15. Default: 6.
resolutionstringVideo resolution. Allowed: 768P, 2K. Default: 2K.
omnihuman-1-5/human-identification · Omnihuman 1.5 Human Identification · POST /v1/generations
FieldTypeDetails
image_url (required)stringPortrait image URL. Requirements: JPG/PNG/JPEG format, less than 5MB, resolution under 4096x4096. Recommended: single person facing forward, with the face occupying a large proportion of the image. Accepted file types: image/jpeg, image/png, image/jpg. Max file size: 5MB.
omnihuman-1-5/subject-detection · OmniHuman 1.5 Subject Detection · POST /v1/generations
FieldTypeDetails
image_url (required)stringPortrait image URL. Supports detection of up to 5 subjects in the image. Accepted file types: image/jpeg, image/png, image/jpg. Max file size: 5MB.
pixverse-v6/extend · PixVerse V6 Video Extension · POST /v1/videos/generations

No input fields beyond the prompt.

pixverse-v6/image-to-video · PixVerse V6 Image-to-Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringGenerate prompt, cannot be empty, length is limited to 3-5000 characters.
image_urls (required)arrayWithout template_id, provide 1 image (used as the first frame). With template_id, provide the number of images given by the template's effect_type (1 or 2). Single image size not exceeding 20 MB. Supports HTTP, HTTPS, and OSS addresses. Supported image formats include JPG, JPEG, PNG, and WebP.
quality (required)stringRequired. Output video resolution. Supports 360p, 540p, 720p, and 1080p. Allowed: 360p, 540p, 720p, 1080p.
duration (required)integerGenerated video duration in seconds, ranging from 1 to 15. Required when template_id is not passed; if template_id is passed, the video duration is fixed by the selected template, please do not pass this parameter at the same time.
generate_audio_switchbooleanWhether to generate audio synchronized with the video content. Default: false.
generate_multi_clip_switchbooleanWhether to generate a multi-clip video. Default: false.
seedintegerRandom seed, value range is 0-2147483647. Using the same parameters and seed helps improve result reproducibility.
template_idstringUsed to select a PixVerse video effect template. Please pass in the corresponding template_id. Once a template_id is provided, the video duration is fixed by the selected template, so duration cannot be set at the same time. effect_type indicates the number of images required by the selected template. Please upload the specified number of images accordingly. To preview the template effect, open .m
pixverse-v6/reference-to-video · PixVerse V6 Fusion / Reference-to-Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringGenerate prompt, cannot be empty, length is limited to 3-5000 characters.
image_references (required)arrayFusion multi-reference image list. `ref_name` must be unique within the same list. You can reference the reference object in the prompt via `@ref_name`.
aspect_ratio (required)stringRequired. Output video aspect ratio. Supported in text-to-video and Fusion multi-reference image to video modes. Allowed: 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9.
quality (required)stringRequired. Output video resolution. Supports 360p, 540p, 720p, and 1080p. Allowed: 360p, 540p, 720p, 1080p.
duration (required)integerRequired. Output video duration in seconds, 1–15.
generate_audio_switchbooleanWhether to generate audio synchronized with the video content. Default: false.
seedintegerRandom seed, value range is 0-2147483647. Using the same parameters and seed helps improve the reproducibility of the results.
pixverse-v6/text-to-video · PixVerse V6 Text-to-Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringGenerate prompt, cannot be empty, length is limited to 3-5000 characters.
aspect_ratio (required)stringRequired. Output video aspect ratio. This parameter is supported in text-to-video and Fusion multi-reference image-to-video modes. Allowed: 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9.
quality (required)stringRequired. Output video resolution. Supports 360p, 540p, 720p, and 1080p. Allowed: 360p, 540p, 720p, 1080p.
duration (required)integerRequired. Output video duration in seconds. PixVerse V6 supports 1–15 seconds.
generate_audio_switchbooleanWhether to generate audio synchronized with the video content. Default: false.
generate_multi_clip_switchbooleanWhether to generate a multi-clip video. Default: false.
seedintegerRandom seed, value range is 0–2147483647. Using the same parameters and seed helps improve result reproducibility.
pixverse-v6/transition · PixVerse V6 First & Last Frame Transition · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringGenerate prompt, cannot be empty, length is limited to 3-5000 characters.
first_frame_image_url (required)stringFirst frame image URL. Supports HTTP, HTTPS, and OSS addresses; supported image formats include JPG, JPEG, PNG, and WebP; the size of a single image file must not exceed 20 MB
last_frame_image_url (required)stringLast frame image URL. Supports HTTP, HTTPS, and OSS addresses; supported image formats include JPG, JPEG, PNG, and WebP; the size of a single image file must not exceed 20 MB
quality (required)stringRequired. Output video resolution. Supports 360p, 540p, 720p, and 1080p. Allowed: 360p, 540p, 720p, 1080p.
duration (required)integerRequired. Output video duration in seconds. PixVerse V6 supports 1–15 seconds.
generate_audio_switchbooleanWhether to generate audio synchronized with the video content. Default: false.
seedintegerRandom seed, value range is 0–2147483647. Using the same parameters and seed helps improve result reproducibility.
runway/gen4-aleph · Generate Aleph Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringDescribes how to transform the input video.
video_url (required)stringReference video URL to base the video-to-video generation on. The AI will transform and enhance this video according to the prompt.
watermarkstringOptional watermark text content. An empty string indicates no watermark, while a non-empty string will display the specified text as a watermark in the video.
upload_cnbooleanOptional. Defaults to false. Default: false.
aspect_ratiostringVideo aspect ratio. Allowed: 16:9, 9:16, 4:3, 3:4, 1:1, 21:9.
seedintegerRandom seed. Set for reproducible generation.
reference_imagestringReference image URL to influence the style or content of the output.
runway/gen4-extend · Extend AI Video · POST /v1/videos/generations
FieldTypeDetails
task_id (required)stringUnique identifier of the original video generation task. Must be a valid task ID from a previously generated video.
prompt (required)stringDescriptive text that guides the continuation of the video. Explain what actions, movements, or developments should happen next. Be specific but maintain consistency with the original video content.
quality (required)stringVideo resolution, optional values are 720p or 1080p.
watermarkstringVideo watermark text content. An empty string indicates no watermark, while a non-empty string will display the specified text as a watermark in the bottom right corner of the video.
runway/gen4-video · Generate AI Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringDescriptive text that guides the AI video generation. Be specific about subject, action, style, and setting. When used with an image, describes how to animate or modify the image content. Maximum length is 1800 characters.
image_urlstringOptional reference image URL to base the video on. When provided, the AI will create a video animating or extending this image.
duration (required)numberVideo duration, optional values are 5 or 10. If 10-second video is selected, 1080p resolution cannot be used
quality (required)stringVideo resolution, optional values are 720p or 1080p. If 1080p is selected, 10-second video cannot be generated
aspect_ratiostringVideo aspect ratio parameter. **Required parameter for text-to-video generation requests. This parameter is invalid when image_url is passed, and the aspect ratio will ultimately be determined by the provided image.** Allowed: 16:9, 4:3, 1:1, 3:4, 9:16.
watermarkstringVideo watermark text content. An empty string indicates no watermark, while a non-empty string will display the specified text as a watermark in the bottom right corner of the video.
veo-3.1 · Generate Veo3.1 Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompt describing the desired video content. Required for all generation modes. - Should be detailed and specific in describing video content - Can include actions, scenes, style and other information - For image-to-video, describe how you want the image to come alive
modelstringVeo 3.1 tier: "veo3_fast" (default), "veo3_lite" or "veo3" (Quality). The top-level model stays "veo-3.1". REFERENCE_2_VIDEO supports veo3_fast and veo3_lite. Allowed: veo3_fast, veo3_lite, veo3. Default: veo3_fast.
image_urlsarrayImage URLs. FIRST_AND_LAST_FRAMES_2_VIDEO: 1 image (first frame) or 2 images (first + last frame). REFERENCE_2_VIDEO: 1–3 reference images, 8-second duration only.
generation_typestringVideo generation mode (optional). Specifies different video generation approaches: - **TEXT_2_VIDEO**: Text-to-video - Generate videos using only text prompts - **FIRST_AND_LAST_FRAMES_2_VIDEO**: First and last frames to video - Flexible image-to-video generation mode - 1 image: Generate video based on the provided image - 2 images: First image as first frame, second image as last frame, generatin Allowed: TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO.
aspect_ratiostringVideo aspect ratio. Specifies the dimension ratio of the generated video. Available options: - 16:9: Landscape video format. - 9:16: Portrait video format, suitable for mobile short videos - Auto: In auto mode, the video will be automatically center-cropped based on whether your uploaded image is closer to 16:9 or 9:16. Default value is 16:9. Allowed: 16:9, 9:16, Auto. Default: 16:9.
enable_fallbackbooleanDeprecated. Remove it from requests. Default: false.
enable_translationbooleanOptional. When true, the prompt is translated to English before generation.
watermarkstringWatermark text. - Optional parameter - If provided, a watermark will be added to the generated video
resolutionstringOutput resolution: 720p (default), 1080p or 4k. For 1080p and 4k, the video URL is in resultJson.data.result_urls (the 720p version is in data.origin_urls). Controls the pixel dimensions of the generated video. Higher resolution results in greater clarity and detail, while lower resolution allows for faster generation. Allowed: 720p, 1080p, 4k. Default: 720p.
durationintegerThe duration of the generated video, in seconds. Optional values are 4, 6, 8. **Important Note**: - The REFERENCE_2_VIDEO mode currently only supports a duration of 8 seconds. Allowed: 4, 6, 8. Default: 8.
veo/extend · Extend Veo3.1 Video · POST /v1/videos/generations
FieldTypeDetails
task_id (required)stringThe task ID of the original video generation. Must be a valid task ID returned by the video generation API.
prompt (required)stringA text prompt describing the content of the extended video. It should detail how you want the video to be extended, including actions, scene changes, styles, etc.
seedsintegerA random seed parameter that controls the randomness of the generated content. Range: 10000-99999. The same seed will generate similar video content, while different seeds will generate different video content. If not specified, the system will automatically assign a random seed.
modelstringExtension tier: "fast" (default), "quality" or "lite". Billed per extension at the chosen tier. Allowed: fast, quality, lite. Default: fast.
watermarkstringWatermark text (optional). If provided, a watermark will be added to the generated video.
veo/get-1080p-video · Get 1080P Video · POST /v1/generations
FieldTypeDetails
taskId (required)stringtaskId
indexstringvideo index
veo/get-4k-video · Get 4K Video · POST /v1/generations
FieldTypeDetails
task_id (required)stringTask ID
indexintegervideo index Default: 0.
vidu-q4/image-to-video · Vidu Q4 Image To Video · POST /v1/videos/generations
FieldTypeDetails
promptstringText description of the motion and scene. Optional. Up to 20,000 characters.
durationintegerVideo length in seconds. Integer from 3 to 16. Default: 5.
resolutionstringOutput resolution. Allowed: 540p, 720p, 1080p, 2k, 4k. Default: 720p.
audiobooleanGenerate synchronized audio (dialogue and sound effects). Set false for a silent video. Default: true.
image_url (required)stringFirst-frame image URL (http/https). JPG, JPEG, PNG or WEBP, up to 50 MB. The video inherits this image's aspect ratio.
vidu-q4/reference-to-video · Vidu Q4 Reference To Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText description of the video. Refer to inputs by order, e.g. "the man in reference image 2 says ... using reference audio 1". Up to 20,000 characters.
durationintegerVideo length in seconds. Integer from 3 to 16. Default: 5.
resolutionstringOutput resolution. Allowed: 540p, 720p, 1080p, 2k, 4k. Default: 720p.
audiobooleanGenerate synchronized audio (dialogue and sound effects). Set false for a silent video. Default: true.
reference_image_urls (required)arrayReference image URLs (http/https), 1 to 15. JPG, JPEG, PNG or WEBP.
reference_audio_urlsarrayOptional reference audio URLs (http/https), up to 3. MP3 only, each 3-12 seconds and up to 50 MB.
aspect_ratiostringOutput aspect ratio. Allowed: 16:9, 9:16, 1:1, 4:3, 3:4. Default: 16:9.
wan/2-2-a14b-image-to-video-turbo · Wan - 2.2 A14B Image to Video Turbo · POST /v1/videos/generations
FieldTypeDetails
image_url (required)stringURL of the input image. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
prompt (required)stringThe text prompt to guide video generation. (Max length: 5000 characters)
resolutionstringResolution of the generated video (480p or 720p). Default value: "720p" Allowed: 480p, 720p. Default: 720p.
enable_prompt_expansionbooleanWhether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning. (Boolean value (true/false))
seednumberOptional. Omit for a random seed.
accelerationstringAcceleration level to use. The more acceleration, the faster the generation, but with lower quality. The recommended value is 'none'. Default value: "none" Allowed: none, regular. Default: none.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-2-a14b-text-to-video-turbo · Wan - 2.2 A14B Text to Video Turbo · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt to guide video generation. (Max length: 5000 characters)
resolutionstringResolution of the generated video (480p or 720p). Default value: "720p" Allowed: 480p, 720p. Default: 720p.
aspect_ratiostringAspect ratio of the generated video (16:9 or 9:16). Default value: "16:9" Allowed: 16:9, 9:16. Default: 16:9.
enable_prompt_expansionbooleanWhether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning. (Boolean value (true/false))
seednumberOptional. Omit for a random seed.
accelerationstringAcceleration level to use. The more acceleration, the faster the generation, but with lower quality. The recommended value is 'none'. Default value: "none" Allowed: none, regular. Default: none.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-5-image-to-video · Wan 2.5 - Image to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt describing the desired video motion. Maximum length: 800 characters.
image_url (required)stringURL of the image to use as the first frame. Must be publicly accessible. - Please provide the URL of the uploaded file, not raw file content - Accepted types: `image/jpeg`, `image/png`, `image/webp` - Max size: 10.0MB
duration (required)stringThe duration of the generated video in seconds. - `5`: 5 seconds - `10`: 10 seconds Allowed: 5, 10.
resolution (required)stringRequired. 720p or 1080p. Allowed: 720p, 1080p.
negative_promptstringNegative prompt used to describe content to avoid. Maximum length: 500 characters.
enable_prompt_expansionbooleanWhether to enable prompt rewriting using LLM. - Boolean value: `true` / `false`
seedintegerRandom seed for reproducibility. If omitted, a random seed is chosen.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-5-text-to-video · Wan 2.5 - Text to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringThe text prompt for video generation. Supports Chinese and English. Maximum length: 800 characters.
duration (required)stringThe duration of the generated video in seconds. - `5`: 5 seconds - `10`: 10 seconds Allowed: 5, 10.
aspect_ratiostringThe aspect ratio of the generated video. - `16:9`: Landscape - `9:16`: Portrait - `1:1`: Square Allowed: 16:9, 9:16, 1:1.
resolution (required)stringRequired. 720p or 1080p. Allowed: 720p, 1080p.
negative_promptstringNegative prompt used to describe content to avoid. Maximum length: 500 characters.
enable_prompt_expansionbooleanWhether to enable prompt rewriting using LLM. Improves results for short prompts but increases processing time. - Boolean value: `true` / `false`
seedintegerRandom seed for reproducibility. If omitted, a random seed is chosen.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-6-flash-image-to-video · Wan - 2.6-flash-image-to-video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompts for video generation. Supports Chinese and English, 2–1,500 characters.
image_urls (required)arrayA list of image URLs. All images must be at least 256x256px. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
durationstringThe duration of the generated video in seconds Allowed: 5, 10, 15. Default: 5.
resolutionstringVideo resolution tier Allowed: 720p, 1080p. Default: 1080p.
audio (required)booleanWhether to generate video with audio. Audio directly affects the cost, as the pricing differs between videos with sound and silent videos. (Boolean value (true/false))
multi_shotsbooleanThe multi shots parameter controls the shot composition style during AI video generation, determining whether the generated video is a single continuous shot or multiple shots with transitions. (Boolean value (true/false))
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-6-flash-video-to-video · Wan - 2-6-flash-video-to-video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompts for video generation. Supports Chinese and English, 2–1,500 characters.
video_urls (required)arrayReference video URLs. (File URL after upload, not file content; Accepted types: video/mp4, video/quicktime, video/x-matroska; Max size: 10.0MB)
durationstringThe duration of the generated video in seconds Allowed: 5, 10. Default: 5.
resolutionstringVideo resolution tier Allowed: 720p, 1080p. Default: 1080p.
audiobooleanWhether to generate video with audio. Audio directly affects the cost, as the pricing differs between videos with sound and silent videos. (Boolean value (true/false))
multi_shotsbooleanThe multi shots parameter controls the shot composition style during AI video generation, determining whether the generated video is a single continuous shot or multiple shots with transitions. (Boolean value (true/false))
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-6-image-to-video · Wan 2.6 - Image to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompts for video generation. Supports both Chinese and English, with a minimum of 2 characters and a maximum of 5,000 characters. (Max length: 5000 characters)
image_urls (required)arrayUpload an image file to use as input for the API (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB),All images must be at least 256x256px.
durationstringThe duration of the generated video in seconds Allowed: 5, 10, 15. Default: 5.
resolutionstringVideo resolution tier Allowed: 720p, 1080p. Default: 1080p.
multi_shotsbooleanThe multi shots parameter controls the shot composition style during AI video generation, determining whether the generated video is a single continuous shot or multiple shots with transitions. Default: false.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-6-text-to-video · Wan 2.6 - Text to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompts for video generation. Supports both Chinese and English, with a minimum of 1 characters and a maximum of 5,000 characters. (Max length: 5000 characters)
durationstringThe duration of the generated video in seconds Allowed: 5, 10, 15. Default: 5.
resolutionstringOutput resolution: 720p or 1080p. Set this field explicitly. Allowed: 720p, 1080p.
multi_shotsbooleanThe multi shots parameter controls the shot composition style during AI video generation, determining whether the generated video is a single continuous shot or multiple shots with transitions. Default: false.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-6-video-to-video · Wan 2.6 - Video to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompts for video generation. Supports both Chinese and English, with a minimum of 2 characters and a maximum of 5,000 characters. (Max length: 5000 characters)
video_urls (required)arrayReference video URLs. (File URL after upload, not file content; Accepted types: video/mp4, video/quicktime, video/x-matroska; Max size: 10.0MB)
durationstringThe duration of the generated video in seconds Allowed: 5, 10. Default: 5.
resolutionstringOutput resolution: 720p or 1080p. Set this field explicitly. Allowed: 720p, 1080p.
multi_shotsbooleanThe multi shots parameter controls the shot composition style during AI video generation, determining whether the generated video is a single continuous shot or multiple shots with transitions. Default: false.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-7-image-to-video · Wan 2.7 - Image to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringPositive prompt. Maximum length: 5000 characters.
negative_promptstringNegative prompt. Maximum length: 500 characters.
first_frame_urlstringFirst frame image URL.
last_frame_urlstringLast frame image URL.
first_clip_urlstringFirst clip video URL, used for video continuation.
driving_audio_urlstringDriving audio URL.
resolutionstringVideo resolution. - `720p`: 720p - `1080p`: 1080p Allowed: 720p, 1080p. Default: 1080p.
durationintegerTotal output video duration in seconds. - Minimum: `2` - Maximum: `15` - Default: `5` Default: 5.
prompt_extendbooleanWhether to enable intelligent prompt rewriting. Default value: `true`. Default: true.
watermarkbooleanWhether to add an AI-generated watermark. Default value: `false`. Default: false.
seedintegerRandom seed. - Minimum: `0` - Maximum: `2147483647`
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-7-r2v · Wan 2.7 - Reference to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringText prompt. Required. Describes the desired elements and visual features in the generated video. Supports Chinese and English. Maximum length: 5000 characters.
negative_promptstringOptional negative prompt describing what should not appear in the video. Supports Chinese and English. Maximum length: 500 characters.
reference_imagearrayArray of reference image URLs. At least one of `reference_image` or `reference_video` must be provided. The total number of images and videos cannot exceed 5.
reference_videoarrayArray of reference video URLs. At least one of `reference_image` or `reference_video` must be provided. The total number of images and videos cannot exceed 5.
first_framestringFirst frame image URL. At most one image can be provided. If supplied, `aspect_ratio` is ignored and the output uses a ratio close to the first frame image.
reference_voicestringAudio URL used to specify the voice timbre of the subject in the reference material. Rules: - If `reference_video` contains audio and `reference_voice` is not provided, the original video audio is used by default - If both `reference_video` and `reference_voice` are provided, `reference_voice` takes priority Audio limits: - Formats: `wav`, `mp3` - Duration: `1` to `10` seconds - File size: up to `
resolutionstringOutput video resolution tier. Available values: `720p`, `1080p`. Default value: `1080p`. Allowed: 720p, 1080p. Default: 1080p.
aspect_ratiostringOutput video aspect ratio. Effective logic: - If `first_frame` is not provided: the video is generated using the specified `aspect_ratio` - If `first_frame` is provided: `aspect_ratio` is ignored and the output uses a ratio close to the first frame image Allowed: 16:9, 9:16, 1:1, 4:3, 3:4. Default: 16:9.
durationintegerOutput video duration in seconds. Valid range is an integer from `2` to `10`. Default value: `5`. Default: 5.
prompt_extendbooleanWhether to enable prompt rewriting. When enabled, the model expands the input prompt. This usually works better for short prompts but increases processing time. Default: true.
watermarkbooleanWhether to add a watermark. The watermark is placed in the lower-right corner of the video with the fixed text "AI generated". Default: false.
seedintegerRandom seed. Range: `0-2147483647`. If omitted, the system generates one automatically.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-7-text-to-video · Wan 2.7 - Text to Video · POST /v1/videos/generations
FieldTypeDetails
prompt (required)stringPositive prompt. Minimum length: 1 character. Maximum length: 5000 characters.
negative_promptstringNegative prompt. Maximum length: 500 characters.
audio_urlstringOptional custom audio URL.
resolutionstringVideo resolution. - `720p`: 720p - `1080p`: 1080p Allowed: 720p, 1080p. Default: 1080p.
ratiostringVideo aspect ratio. - `16:9`: Landscape - `9:16`: Portrait - `1:1`: Square - `4:3`: Landscape 4:3 - `3:4`: Portrait 3:4 Allowed: 16:9, 9:16, 1:1, 4:3, 3:4. Default: 16:9.
durationintegerVideo duration in seconds. - Minimum: `2` - Maximum: `15` - Default: `5` Default: 5.
prompt_extendbooleanWhether to enable intelligent prompt rewriting. Default value: `true`. Default: true.
watermarkbooleanWhether to add an AI-generated watermark. Default value: `false`. Default: false.
seedintegerRandom seed. - Minimum: `0` - Maximum: `2147483647`
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-7-videoedit · Wan 2.7 - Video Edit · POST /v1/videos/generations
FieldTypeDetails
promptstringOptional text prompt describing the expected elements and visual features in the generated video. Supports Chinese and English. Maximum length: 5000 characters.
negative_promptstringOptional negative prompt describing content that should not appear in the video. Supports Chinese and English. Maximum length: 500 characters.
video_url (required)stringURL of the source video to edit. Required. Only one video is supported. - Formats: `mp4`, `mov` - Duration: `2` to `10` seconds - Resolution: width and height range `[240,4096]` pixels - Aspect ratio: `1:8` to `8:1` - File size: up to `100MB` - Supports public `http/https` URLs or temporary `oss` URLs
reference_imagestringOptional reference image URL for character, clothing, or style guidance. - Formats: `JPEG`, `JPG`, `PNG` (no alpha channel), `WEBP` - Resolution: width and height range `[240,8000]` pixels - Aspect ratio: `1:8` to `8:1` - Supports public `http/https` URLs or temporary `oss` URLs
resolutionstringOutput video resolution tier. `1080p` costs more than `720p`. Default value: `1080p`. - `720p`: 720p - `1080p`: 1080p Allowed: 720p, 1080p. Default: 1080p.
aspect_ratiostringOutput video aspect ratio. - If omitted: the output uses an aspect ratio close to the input video - If provided: the output uses the specified aspect ratio - Available values: `16:9`, `9:16`, `1:1`, `4:3`, `3:4` Allowed: 16:9, 9:16, 1:1, 4:3, 3:4.
durationintegerOutput video duration in seconds. - Default `0` means using the full input video duration without truncation - If a value is provided, the output is clipped from second `0` to the specified length - Valid values are `0` or any integer in `[2,10]` Default: 0.
audio_settingstringVideo audio setting. - `auto`: default, the model decides whether to regenerate audio based on the `prompt` - `origin`: force keeping the original input video audio Allowed: auto, origin. Default: auto.
prompt_extendbooleanWhether to enable prompt rewriting. When enabled, the model expands the input prompt. This usually works better for short prompts but increases processing time. Default: true.
watermarkbooleanWhether to add a watermark. The watermark is placed in the lower-right corner of the video with the fixed text "AI generated". Default: false.
seedintegerRandom seed. Range: `0-2147483647`. If omitted, the system generates one automatically.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/3-0-video · Wan 3.0 - Video · POST /v1/videos/generations
FieldTypeDetails
promptstringText prompt, supporting both Chinese and English. Up to 20,000 characters. Required for text-to-video generation; for other modes, it is recommended to provide it together with media. In reference mode, use Image1/Video1/Audio1 to reference the provided media.
first_frame_urlstringURL of the first-frame image. Up to 1 image, used strictly as the first frame of the video. Used for first-frame-to-video / first-and-last-frame-to-video generation. Cannot be provided together with `reference_*_urls`. Formats: JPEG/JPG, PNG (transparency not supported), BMP, WEBP; each side [240, 8000] px; aspect ratio ≤ 8:1; ≤ 20MB.
last_frame_urlstringURL of the last-frame image. Use together with first_frame_url. Same format limits as first_frame_url.
reference_image_urlsarrayReference images for the all-purpose reference mode, with up to 10 images. Correspond to Image1, Image2, … in the prompt according to array order. Specifications are the same as `first_frame_url`. Cannot be provided together with the first-frame/last-frame parameters.
reference_video_urlsarrayReference videos for the all-purpose reference mode, with up to 5 clips. Each clip must be 1–15 seconds, with a total duration ≤ 15 seconds. Correspond to Video1, Video2, … according to array order. Formats: mp4, mov; each side [240, 4096] px; aspect ratio ≤ 8:1; each file ≤ 100MB. There is an additional constraint on the output side: the input video duration + `duration` must not exceed 30 second
reference_audio_urlsarrayReference audio for the all-purpose reference mode, with up to 5 clips. Each clip must be 1–15 seconds, with a total duration ≤ 15 seconds. Correspond to Audio1, Audio2, … according to array order. Formats: wav, mp3; ≤ 15MB. Reference audio can be used as the only media input; pairing it with a reference image or video usually gives better results.
reference_file_urlsarrayFile-to-video generation. Up to 1 file. Cannot be provided together with `reference_link_urls`, or with the first-frame/last-frame parameters. Formats: docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md; ≤ 100MB; pdf/docx/ppt/key/pages, etc. ≤ 50 pages.
reference_link_urlsarrayLink-to-video generation. Up to 1 publicly accessible webpage that does not require login. Cannot be provided together with `reference_file_urls`, or with the first-frame/last-frame parameters.
resolutionstringOutput resolution. Default: **1080P**. Allowed: 480P, 720P, 1080P. Default: 1080P.
aspect_ratiostringOutput aspect ratio. `adaptive` (default) automatically selects the ratio based on the input media and intent. Allowed: adaptive, 16:9, 4:3, 1:1, 3:4, 9:16. Default: adaptive.
durationintegerOutput video duration in seconds. Default: 5. Without video input, the range is [2, 30]. With reference videos: input video duration + output duration ≤ 30. Pass `-1` to use an intelligent duration determined by the model. Default: 5.
audiobooleanWhether the output video includes an audio track. Default: true. Default: true.
seedintegerRandom seed used to reproduce results. If omitted, a random seed will be used.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/3-0-video-prime · Wan 3.0 - Video Prime · POST /v1/videos/generations
FieldTypeDetails
promptstringText prompt. Chinese and English are supported. Up to 20,000 characters. Required for text-to-video; for other modes, it is recommended to provide it together with media. In reference mode, use Image1/Video1/Audio1 to reference the provided materials.
first_frame_urlstringURL of the first-frame image. Up to 1 image, used strictly as the first frame of the video. Used for first-frame-to-video or first-and-last-frame-to-video generation. Cannot be provided together with `reference_*_urls`. Formats: JPEG/JPG, PNG (transparency not supported), BMP, WEBP; each side [240, 8000] px; aspect ratio ≤ 8:1; ≤ 20MB.
last_frame_urlstringURL of the last-frame image. Use together with first_frame_url. Same format limits as first_frame_url.
reference_image_urlsarrayReference images for all-purpose reference mode. Up to 10 images. Correspond to Image1, Image2, and so on in the prompt according to array order. Same specifications as `first_frame_url`. Cannot be provided together with the first-frame or last-frame image.
reference_video_urlsarrayReference videos for all-purpose reference mode. Up to 5 videos. Each video must be 1–15s, with a combined duration of ≤ 15s. Correspond to Video1, Video2, and so on according to array order. Formats: mp4, mov; each side [240, 4096] px; aspect ratio ≤ 8:1; each file ≤ 100MB. There is an additional output-side limit: the input video duration plus `duration` cannot exceed 30 seconds.
reference_audio_urlsarrayReference audio files for all-purpose reference mode. Up to 5 audio files. Each file must be 1–15s, with a combined duration of ≤ 15s. Correspond to Audio1, Audio2, and so on according to array order. Formats: wav, mp3; ≤ 15MB. Reference audio can be used as the only media input; pairing it with a reference image or video usually gives better results.
reference_file_urlsarrayFile-to-video generation. Up to 1 file. Cannot be provided together with `reference_link_urls`, or with the first-frame/last-frame image. Formats: docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md; ≤ 100MB; pdf/docx/ppt/key/pages, etc. ≤ 50 pages.
reference_link_urlsarrayLink-to-video generation. Up to 1 publicly accessible webpage that does not require login. Cannot be provided together with `reference_file_urls`, or with the first-frame/last-frame image.
resolutionstringOutput resolution level. Default: **1080P**. Allowed: 480P, 720P, 1080P. Default: 1080P.
aspect_ratiostringOutput aspect ratio. `adaptive` (default) automatically selects the aspect ratio based on the input materials and intent. Allowed: adaptive, 16:9, 4:3, 1:1, 3:4, 9:16. Default: adaptive.
durationintegerOutput video duration in seconds. Default: 5. When there is no video input, the value must be within [2, 30]. When reference videos are provided: input video duration plus output duration ≤ 30. Pass `-1` to use an intelligent duration determined by the model. Default: 5.
audiobooleanWhether the output video includes an audio track. Default: true. Default: true.
seedintegerRandom seed used to reproduce results. If omitted, a random seed is used.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.

Lip-sync and avatars

infinitalk/from-audio · Infinitalk - From Audio · POST /v1/generations
FieldTypeDetails
image_url (required)stringURL of the input image. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
audio_url (required)stringThe URL of the audio file. (File URL after upload, not file content; Accepted types: audio/mpeg, audio/wav, audio/x-wav, audio/aac, audio/mp4, audio/ogg; Max size: 10.0MB)
prompt (required)stringThe text prompt to guide video generation. (Max length: 5000 characters)
resolutionstringResolution of the video to generate. Must be either 480p or 720p. Allowed: 480p, 720p. Default: 480p.
seednumberRandom seed for reproducibility. Valid range is 10000 to 1000000.
kling/ai-avatar-pro · Kling AI Avatar Pro · POST /v1/generations
FieldTypeDetails
image_url (required)stringThe URL of the image to use as your avatar (File URL after upload, not file content; Accepted types: image/jpeg, image/png; Max size: 10.0MB)
audio_url (required)stringThe URL of the audio file (must be the URL of the uploaded file, not the file content; supported formats: audio/mpeg, audio/wav, audio/x-wav, audio/aac, audio/mp4, audio/ogg; audio size is limited to 100M, and the duration cannot exceed 5 minutes)
prompt (required)stringRequired, non-empty. Describe the avatar's expression, movement and camera; the speech comes from audio_url. Up to 5,000 characters.
kling/ai-avatar-standard · Kling AI Avatar Standard · POST /v1/generations
FieldTypeDetails
image_url (required)stringThe URL of the image to use as your avatar (File URL after upload, not file content; Accepted types: image/jpeg, image/png; Max size: 10.0MB)
audio_url (required)stringThe URL of the audio file (must be the URL of the uploaded file, not the file content; supported formats: audio/mpeg, audio/wav, audio/x-wav, audio/aac, audio/mp4, audio/ogg; audio size is limited to 100M, and the duration cannot exceed 5 minutes)
prompt (required)stringRequired, non-empty. Describe the avatar's expression, movement and camera; the speech comes from audio_url. Up to 5,000 characters.
omnihuman-1-5 · Omnihuman 1.5 · POST /v1/generations
FieldTypeDetails
image_url (required)stringPortrait image URL. Supports any aspect ratio with subjects including people, pets, anime, etc. Accepted file types: image/jpeg, image/png, image/webp. Max file size: 10MB.
mask_urlarrayOptional mask image URL(s). To have a specific subject in the image speak, use 'Subject Detection' to get the corresponding mask image and pass it as input. Accepted file types: image/jpeg, image/png, image/webp. Max file size: 10MB. Multiple file upload is supported, up to 5 files.
audio_url (required)stringAudio URL. Duration must be less than 60 seconds (recommended 15 seconds or less; exceeding this will cause quality degradation). Accepted file types: audio/mpeg, audio/wav, audio/x-wav, audio/aac, audio/ogg, audio/mp4. Max file size: 10MB.
promptstringOptional. Supported languages: Chinese, English, Japanese, Korean, Spanish, Indonesian. Up to 300 characters.
output_resolutionstringOutput video resolution. - `720`: 720P - `1080`: 1080P (default) The output keeps the aspect ratio of the input image; 720 and 1080 are resolution tiers, not exact heights. The output is an MP4 as long as the audio. Allowed: 720, 1080. Default: 1080.
pe_fast_modebooleanFast mode. Sacrifices some quality to speed up generation. Default value: `false`. Default: false.
seedintegerRandom seed. Default is `-1` (random). When using the same positive integer and keeping all other parameters identical, the result will be highly consistent. Default: -1.
volcengine/video-to-video-lip-sync · Volcengine video to video lip sync · POST /v1/generations
FieldTypeDetails
mode (required)stringService mode for lip-sync generation. - `lite`: For single-person frontal videos. Faster processing. - `basic`: For single-person complex scenes. Supports scene segmentation and speaker identification. Allowed: lite, basic.
video_url (required)stringVideo URL. Supported resolution: 360p–1080p. Videos above 1080p will be compressed to 1080p, while videos below 360p are not supported. Supported formats: MOV, MP4, HDR, MKV. Recommended codec: H.264. Other formats/codecs may be transcoded. Max file size: 500 MB. Bitrate: 1–30 Mbps. Frame rate: 24–60 fps.
audio_url (required)stringTarget pure vocal audio URL; used to drive video lip movements. Audio duration: over 1 s and up to 240 s in lite mode; over 1 s and up to 210 s in basic mode. Accepted file types: audio/mpeg, audio/wav, audio/x-wav, audio/aac, audio/mp4, audio/ogg. Max file size: 10MB.
separate_vocalbooleanEnable vocal separation to suppress background noise. Default value: `false`. Default: false.
open_scenedetbooleanWhether to enable scene segmentation and speaker identification. Supported only in Basic mode. Default value: `false`. Default: false.
align_audiobooleanSupported in Lite mode. Whether to loop the video when the audio is longer than the video. Default value: `true`. Default: true.
align_audio_reversebooleanSupported in Lite mode. Whether to loop the video in reverse (backward). Requires `align_audio` to be set to `true`. Default value: `false`. Default: false.
templ_start_secondsnumberSupported in Lite mode. Start time of the template video, in seconds. Default value: `0`. Default: 0.
wan/2-2-a14b-speech-to-video-turbo · Wan - 2.2 A14B Speech to Video Turbo · POST /v1/generations
FieldTypeDetails
prompt (required)stringThe text prompt used for video generation (Max length: 5000 characters)
image_url (required)stringURL of the input image. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
audio_url (required)stringThe URL of the audio file (File URL after upload, not file content; Accepted types: audio/mp3, audio/wav, audio/ogg, audio/m4a, audio/flac, audio/aac, audio/x-ms-wma, audio/mpeg; Max size: 10.0MB)
num_framesnumberNumber of frames to generate. Must be between 40 to 120, (must be multiple of 4) (Min: 40, Max: 120, Step: 4) (step: 4) Default: 80.
frames_per_secondnumberFrames per second of the generated video. Must be between 4 to 60. (Min: 4, Max: 60, Step: 1) (step: 1) Default: 16.
resolutionstringResolution of the generated video (480p, 580p, or 720p) Allowed: 480p, 580p, 720p. Default: 480p.
negative_promptstringNegative prompt for video generation (Max length: 500 characters)
seedintegerOptional. Omit for a random seed.
num_inference_stepsnumberNumber of inference steps for sampling. Higher values give better quality but take longer (Min: 2, Max: 40, Step: 1) (step: 1) Default: 27.
guidance_scalenumberClassifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality (Min: 1, Max: 10, Step: 0.1) (step: 0.1) Default: 3.5.
shiftnumberShift value for the video. Must be between 1.0 and 10.0 (Min: 1, Max: 10, Step: 0.1) (step: 0.1) Default: 5.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-2-animate-move · Wan - Animate Move · POST /v1/generations
FieldTypeDetails
video_url (required)stringURL of the input video. (File URL after upload, not file content; Accepted types: video/mp4, video/quicktime, video/x-matroska; Max size: 10.0MB)
image_url (required)stringURL of the input image. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
resolutionstringResolution of the generated video (480p, 580p, or 720p). Allowed: 480p, 580p, 720p. Default: 480p.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
wan/2-2-animate-replace · Wan - Animate Replace · POST /v1/generations
FieldTypeDetails
video_url (required)stringURL of the input video. (File URL after upload, not file content; Accepted types: video/mp4, video/quicktime, video/x-matroska; Max size: 10.0MB)
image_url (required)stringURL of the input image. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
resolutionstringResolution of the generated video (480p, 580p, or 720p). Allowed: 480p, 580p, 720p. Default: 480p.
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.

Upscaling

grok-imagine/upscale · Grok Imagine - Video Upscale · POST /v1/generations
FieldTypeDetails
task_id (required)stringTask ID from a previously successful video generation task. Required field. - task_id must be a successful grok-imagine/text-to-video or grok-imagine/image-to-video task. - The original video generation must have completed successfully - Only Omni AI–generated task IDs are supported
resolutionstringVideo generation resolution. Allowed: 720p, 1080p. Default: 720p.
recraft/crisp-upscale · Recraft - Crisp Upscale · POST /v1/generations
FieldTypeDetails
image (required)stringImage to upscale (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
topaz/image-upscale · Topaz - Image Upscale · POST /v1/generations
FieldTypeDetails
image_url (required)stringUrl of the image to be upscaled (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
upscale_factor (required)stringFactor to upscale the image by (e.g. 2 doubles width and height). Allowed: 1, 2, 4. Default: 2.
topaz/video-upscale · Topaz - Video Upscale · POST /v1/generations
FieldTypeDetails
video_url (required)stringURL of the video to upscale (File URL after upload, not file content; Accepted types: video/mp4, video/quicktime, video/x-matroska; Max size: 50.0MB)
upscale_factorstringUpscale factor (string): "1", "2" (default) or "4". Allowed: 1, 2, 4. Default: 2.

Speech

elevenlabs/text-to-dialogue-v3 · elevenlabs/text-to-dialogue-v3 · POST /v1/generations
FieldTypeDetails
dialogue (required)arrayArray of dialogue items. Each item contains text and voice. The total character count of all text fields combined must not exceed 5000 characters.
stabilitynumberVoice stability parameter. Must be one of the following values: 0.0, 0.5, or 1.0 Allowed: 0, 0.5, 1. Default: 0.5.
language_codestringLanguage code for the speech. Default is empty string or omit the parameter for automatic language detection.
elevenlabs/text-to-speech-multilingual-v2 · elevenlabs/text-to-speech-multilingual-v2 · POST /v1/generations
FieldTypeDetails
text (required)stringThe text to convert to speech (Max length: 5000 characters)
voice (required)stringVoice ID from the list below. You can preview a voice by opening .mp3 in your browser (replace with the actual voice ID). For example: Available voices: EkK5I93UQWFDigLMpZcX - James - Husky, Engaging and Bold Z3R5wn05IrDiVCyEkUrK - Arabella - Mysterious and Emotive NNl6r8mD7vthiJatiJt1 - Bradford - Expressive and Articulate YOq2y2Up4RgXP2HyXjE5 - Xavier - Dominating, Metallic Announcer B8gJV1Ihpue Default: EkK5I93UQWFDigLMpZcX.
stabilitynumberVoice stability (0-1) (Min: 0, Max: 1, Step: 0.01) (step: 0.01) Default: 0.5.
similarity_boostnumberSimilarity boost (0-1) (Min: 0, Max: 1, Step: 0.01) (step: 0.01) Default: 0.75.
stylenumberStyle exaggeration (0-1) (Min: 0, Max: 1, Step: 0.01) (step: 0.01) Default: 0.
speednumberSpeech speed (0.7-1.2). Values below 1.0 slow down the speech, above 1.0 speed it up. Extreme values may affect quality. (Min: 0.7, Max: 1.2, Step: 0.01) (step: 0.01) Default: 1.
timestampsbooleanWhether to return timestamps for each word in the generated speech (Boolean value (true/false))
previous_textstringThe text that came before the text of the current request. Can be used to improve the speech's continuity when concatenating together multiple generations or to influence the speech's continuity in the current generation. (Max length: 5000 characters)
next_textstringThe text that comes after the text of the current request. Can be used to improve the speech's continuity when concatenating together multiple generations or to influence the speech's continuity in the current generation. (Max length: 5000 characters)
language_codestringLanguage code (ISO 639-1) used to enforce a language for the model. Currently only Turbo v2.5 and Flash v2.5 support language enforcement. For other models, an error will be returned if language code is provided. (Max length: 500 characters)
elevenlabs/text-to-speech-turbo-2-5 · elevenlabs/text-to-speech-turbo-2-5 · POST /v1/generations
FieldTypeDetails
text (required)stringThe text to convert to speech (Max length: 5000 characters)
voicestringVoice ID from the list below. You can preview a voice by opening .mp3 in your browser (replace with the actual voice ID). For example: Available voices: EkK5I93UQWFDigLMpZcX - James - Husky, Engaging and Bold Z3R5wn05IrDiVCyEkUrK - Arabella - Mysterious and Emotive NNl6r8mD7vthiJatiJt1 - Bradford - Expressive and Articulate YOq2y2Up4RgXP2HyXjE5 - Xavier - Dominating, Metallic Announcer B8gJV1Ihpue Default: EkK5I93UQWFDigLMpZcX.
stabilitynumberVoice stability (0-1) (Min: 0, Max: 1, Step: 0.01) (step: 0.01) Default: 0.5.
similarity_boostnumberSimilarity boost (0-1) (Min: 0, Max: 1, Step: 0.01) (step: 0.01) Default: 0.75.
stylenumberStyle exaggeration (0-1) (Min: 0, Max: 1, Step: 0.01) (step: 0.01) Default: 0.
speednumberSpeech speed (0.7-1.2). Values below 1.0 slow down the speech, above 1.0 speed it up. Extreme values may affect quality. (Min: 0.7, Max: 1.2, Step: 0.01) (step: 0.01) Default: 1.
timestampsbooleanWhether to return timestamps for each word in the generated speech (Boolean value (true/false))
previous_textstringThe text that came before the text of the current request. Can be used to improve the speech's continuity when concatenating together multiple generations or to influence the speech's continuity in the current generation. (Max length: 5000 characters)
next_textstringThe text that comes after the text of the current request. Can be used to improve the speech's continuity when concatenating together multiple generations or to influence the speech's continuity in the current generation. (Max length: 5000 characters)
language_codestringLanguage code (ISO 639-1) used to enforce a language for the model. Currently only Turbo v2.5 and Flash v2.5 support language enforcement. For other models, an error will be returned if language code is provided. (Max length: 500 characters)
google/gemini-2-5-pro-tts · Gemini 2.5 Pro Text to Speech · POST /v1/generations
FieldTypeDetails
temperaturenumberSampling temperature, e.g., 1 Default: 1.
scenestringScene description, e.g., "A quiet, warm room with a fireplace crackling softly." Default: .
sample_contextstringSample context/overall tone, e.g., "Audiobook style narration. Tone is gentle and inviting." Default: .
speakers (required)arrayList of speaker configurations
dialogue_turns (required)arrayList of dialogue turns, output in sequential order
google/gemini-3-1-flash-tts · Gemini 3.1 Flash Text to speech · POST /v1/generations
FieldTypeDetails
temperaturenumberSampling temperature, e.g., 1 Default: 1.
scenestringScene description, e.g., "A quiet, warm room with a fireplace crackling softly." Default: .
sample_contextstringSample context/overall tone, e.g., "Audiobook style narration. Tone is gentle and inviting." Default: .
speakers (required)arrayList of speaker configurations
dialogue_turns (required)arrayList of dialogue turns, output in sequential order
google/gemini-3-8-flash-lite-tts · Gemini 3.8 Flash Lite Text to speech · POST /v1/generations
FieldTypeDetails
temperaturenumberSampling temperature, e.g., 1 Default: 1.
speakers (required)arrayList of speaker configurations. Each speaker uses either `voice_name` (preset voice) or `replica` (voice clone); the two are mutually exclusive. If neither is sent, the speaker defaults to `Fola`.
filler_wordsbooleanWhether to insert filler words in two-speaker dialogue. Off by default (omit this field); when enabled, the request includes `"filler_words": true`. Only takes effect when `speakers` has two speakers (e.g. Speaker 1 and Speaker 2). When two people are speaking, you can turn on this switch. Default: false.
dialogue_turns (required)arrayList of dialogue turns, output in sequential order
google/gemini-3-8-flash-tts · Gemini 3.8 Flash Text to speech · POST /v1/generations
FieldTypeDetails
temperaturenumberSampling temperature, e.g., 1 Default: 1.
speakers (required)arrayList of speaker configurations. Each speaker uses either `voice_name` (preset voice) or `replica` (voice clone); the two are mutually exclusive. If neither is sent, the speaker defaults to `Fola`.
filler_wordsbooleanWhether to insert filler words in two-speaker dialogue. Off by default (omit this field); when enabled, the request includes `"filler_words": true`. Only takes effect when `speakers` has two speakers (e.g. Speaker 1 and Speaker 2). When two people are speaking, you can turn on this switch. Default: false.
dialogue_turns (required)arrayList of dialogue turns, output in sequential order

Audio tools

elevenlabs/audio-isolation · elevenlabs/audio-isolation · POST /v1/generations
FieldTypeDetails
audio_url (required)stringURL of the audio file to isolate voice from (File URL after upload, not file content; Accepted types: audio/mpeg, audio/wav, audio/x-wav, audio/aac, audio/mp4, audio/ogg; Max size: 10.0MB)

Music suite

suno/add-instrumental · Add Instrumental to Music · POST /v1/generations
FieldTypeDetails
upload_url (required)stringURL of the uploaded audio file. Required. Source audio (`upload_url`) is enough to generate once `title`, `negative_tags`, and `tags` are provided.
modelstringThe AI model version to use for generation. - Available options: - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details. - **`V5_5`** (Discontinued): Custom Models Tailored to Your Unique Allowed: V4_5PLUS, V5, V5_5, V6, V6_MINI, V6_WILD. Default: V6.
title (required)stringTitle of the generated music. Required. Will be displayed in the player interface and file name.
negative_tags (required)stringMusic styles or characteristics to exclude from the generated audio. Required. Used to avoid specific unwanted music elements.
tags (required)stringMusic styles or tags to include in the generated music. Required. Defines the desired music style and characteristics.
vocal_genderstringVocal gender preference. Optional. 'm' for male, 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions. Allowed: m, f.
style_weightnumberAdherence strength to specified style. Optional. Range 0–1, up to 2 decimal places.
weirdness_constraintnumberControls experimental/creative deviation level. Optional. Range 0–1, up to 2 decimal places.
audio_weightnumberRelative weight of audio elements. Optional. Range 0–1, up to 2 decimal places.
lyricsstringLyrics for the generated audio. Optional. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`upload_url`) is enough to generate once `title`, `negative_tags`, and `tags` are provided.
varietyintegerControls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encou Default: 1.
suno/add-vocals · Add Vocals to Music · POST /v1/generations
FieldTypeDetails
promptstringPrompt for generating audio. Optional. - Used as lyrics only when `lyrics` is not provided. If `lyrics` is present, `prompt` is not used as lyrics. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters.
modelstringThe AI model version to use for generation. - Available options: - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details. - **`V5_5`** (Discontinued): Custom Models Tailored to Your Unique Allowed: V4_5PLUS, V5, V5_5, V6, V6_MINI, V6_WILD. Default: V6.
title (required)stringMusic title. Required. Will be displayed in the player interface and file name.
negative_tags (required)stringExcluded music styles. Required. Used to avoid including specific styles or elements in the generated music.
style (required)stringMusic style. Required. Such as jazz, electronic, classical and other music types.
vocal_genderstringVocal gender preference. Optional. 'm' for male, 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions. Allowed: m, f.
style_weightnumberAdherence strength to specified style. Optional. Range 0–1, up to 2 decimal places.
weirdness_constraintnumberControls experimental/creative deviation level. Optional. Range 0–1, up to 2 decimal places.
audio_weightnumberRelative weight of audio elements. Optional. Range 0–1, up to 2 decimal places.
upload_url (required)stringURL of the uploaded audio file. Required. Source audio (`upload_url`) is enough to generate once `title`, `negative_tags`, and `style` are provided.
lyricsstringLyrics for the generated audio. Optional. - Takes priority over `prompt` as lyrics. If omitted, `prompt` is used as lyrics when provided. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`upload_url`) is enough to generate once `title`, `negative_tags`, and `style` are provided.
varietyintegerControls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encou Default: 1.
suno/boost-music-style · Boost Music Style · POST /v1/generations
FieldTypeDetails
content (required)stringStyle description. Please describe in concise and clear language the music style you expect to generate. Example: 'Pop, Mysterious'
suno/check-voice · Suno Voice Check Availability API · POST /v1/generations
FieldTypeDetails
task_id (required)stringTask ID that needs to be checked
suno/convert-to-wav-format · Convert to WAV Format · POST /v1/generations
FieldTypeDetails
task_id (required)stringUnique identifier of the music generation task. This should be a task_id returned from either the "Generate Music" or "Extend Music" endpoints.
audio_id (required)stringUnique identifier of the specific audio track to convert. This ID is returned in the webhook_url data after music generation completes.
suno/cover-generate · Generate Music Cover · POST /v1/generations
FieldTypeDetails
task_id (required)stringOriginal music task ID, should be the task_id returned by the music generation interface.
suno/create-music-video · Create Music Video · POST /v1/generations
FieldTypeDetails
task_id (required)stringUnique identifier of the music generation task. This should be a task_id returned from either the "Generate Music" or "Extend Music" endpoints.
audio_id (required)stringUnique identifier of the specific audio track to visualize. This ID is returned in the webhook_url data after music generation completes.
authorstringArtist or creator name to display as a signature on the video cover. Maximum 50 characters. This creates attribution for the music creator.
domain_namestringWebsite or brand to display as a watermark at the bottom of the video. Maximum 50 characters. Useful for promotional branding or attribution.
suno/create-voice · Suno Voice Create Custom Voice API · POST /v1/generations
FieldTypeDetails
task_id (required)stringTask ID
verify_url (required)stringAudio URL for the user's recording of the server-returned `validateInfo` validation phrase. For best voice generation results, recording the phrase in a singing voice rather than plain speech is recommended. [Required]
voice_namestringVoice name
descriptionstringVoice description
stylestringVoice style
singer_skill_levelstringSinger skill level. Supported: beginner, intermediate, advanced, professional Allowed: beginner, intermediate, advanced, professional. Default: beginner.
suno/extend · Extend Music · POST /v1/generations
FieldTypeDetails
audio_id (required)stringUnique identifier of the audio track to extend. Required for all extension requests.
promptstringLyrics for the extended audio. Optional. - Used as lyrics only when `lyrics` is not provided. If `lyrics` is present, `prompt` is not used as lyrics. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`audio_id`) is enough to generate. - Do not pass this parameter when `instrumental` is `true`.
stylestringMusic style specification for the extended audio. Optional. - Not required. Source audio (`audio_id`) is enough to generate. - Character limits by model: - **V4** (Discontinued): Maximum 200 characters - **V4_5 & V4_5PLUS** (Discontinued): Maximum 1000 characters - **V4_5ALL** (Discontinued): Maximum 1000 characters - **V5_5 & V5** (Discontinued): Maximum 1000 characters - **V6, V6_MINI, and V6_WI
titlestringTitle for the extended music track. Optional. - Maximum 100 characters. - Displayed in player interfaces and filenames.
continue_atnumberThe time point (in seconds) from which to start extending the music. - Value range: greater than 0 and less than the total duration of the generated audio. - Specifies the position in the original track where the extension should begin.
model (required)stringRequired. Use V6, V6_MINI or V6_WILD. - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details. Allowed: V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5, V6, V6_WILD, V6_MINI.
negative_tagsstringMusic styles or traits to exclude from the extended audio. Optional. Use to avoid specific undesired characteristics.
vocal_genderstringVocal gender preference. Optional. 'm' denotes a male voice, and 'f' denotes a female voice. In practice, this parameter only influences the probability and does not guarantee strict adherence to the gender instruction. This parameter is not required if `instrumental` is set to `true`. Allowed: m, f.
style_weightnumberStrength of adherence to the specified style. Optional. Range 0–1, up to 2 decimal places.
weirdness_constraintnumberControls experimental/creative deviation. Optional. Range 0–1, up to 2 decimal places.
audio_weightnumberBalance weight for audio features vs. other factors. Optional. Range 0–1, up to 2 decimal places.
persona_idstringPersona ID or Voice ID to apply to the generated music. Optional. Use this to apply a specific persona style to your music generation. To generate a Persona ID, use the Generate Persona endpoint to create a personalized music Persona based on generated music. To generate a Voice ID, use the Generate Voice endpoint.
persona_modelstringThe persona model is only applicable to the V5 (deactivated), V5.5 (deactivated), V6, V6_MINI, and V6_WILD models. Allowed: style_persona, voice_persona.
instrumentalbooleanIndicates whether it is an instrumental track. If true, passing the `lyrics`, `prompt`, and `vocal_gender` parameters is prohibited. Default: false.
lyricsstringLyrics for the extended audio. Optional. - Takes priority over `prompt` as lyrics. If omitted, `prompt` is used as lyrics when provided. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`audio_id`) is enough to generate. - Do not pass this parameter when `instrumental` is `true`.
varietyintegerControls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encou Default: 1.
suno/generate · Generate Music · POST /v1/generations
FieldTypeDetails
promptstringA description of the desired audio content. Optional. - Custom mode (`custom_mode=true`): When provided, the prompt is used strictly as lyrics and sung in the generated track. Character limits by model: - V4: Maximum 3000 characters - V4_5, V4_5PLUS, V4_5ALL, V5_5, V5: Maximum 5000 characters - Non-custom mode (`custom_mode=false`): When provided, the prompt serves as the core idea. Lyrics are gen
stylestringMusic style specification for the generated audio. - Character limits by model: - **V4** (Discontinued): Maximum 200 characters - **V4_5 and V4_5PLUS** (Discontinued): Maximum 1000 characters - **V4_5ALL** (Discontinued): Maximum 1000 characters - **V5_5 and V5** (Discontinued): Maximum 1000 characters - **V6, V6_MINI, and V6_WILD**: Maximum 1000 characters - Common examples: Jazz, Classical, Elec
titlestringTitle for the generated music track. - Required in Custom Mode (`custom_mode: true`). - Max length: 80 characters. - Will be displayed in player interfaces and filenames.
custom_mode (required)booleanDetermines whether advanced parameter customization is enabled. - If `true`: Allows detailed control - If `false`: Simplified mode
instrumental (required)booleanWhether to generate instrumental music (no vocals). See Parameter Details for the fields required in each mode.
model (required)stringRequired. Use V6, V6_MINI or V6_WILD. - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details. Allowed: V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5, V6, V6_MINI, V6_WILD.
negative_tagsstringMusic styles or traits to exclude from the generated audio. Optional. Use to avoid specific styles.
vocal_genderstringVocal gender preference. Optional. Use `m` for male and `f` for female. This parameter is only effective when `custom_mode` is true. In practice, it only increases probability and cannot guarantee male/female voice instructions are followed. Allowed: m, f.
style_weightnumberOnly available when Custom Mode (`custom_mode: true`) is enabled. Strength of adherence to the specified style. Optional. Range 0–1, up to 2 decimal places.
weirdness_constraintnumberOnly available when Custom Mode (`custom_mode: true`) is enabled. Controls experimental/creative deviation. Optional. Range 0–1, up to 2 decimal places.
audio_weightnumberOnly available when Custom Mode (`custom_mode: true`) is enabled. Relative weight of audio features. Optional. Range 0–1, up to 2 decimal places. - `audio_weight` is not supported when there are no vocals
persona_idstringPersona ID or Voice ID to apply to the generated music. Optional. Use this to apply a specific persona style to your music generation. To generate a Persona ID, use the Generate Persona endpoint to create a personalized music Persona based on generated music. To generate a Voice ID, use the Generate Voice endpoint.
persona_modelstringPersona model. Only available for V5 (Discontinued), V5.5 (Discontinued), V6, V6_MINI, and V6_WILD. Allowed: style_persona, voice_persona.
durationnumberTarget length in seconds (10–360). Optional; if omitted, the model chooses the length. Only valid when `custom_mode` is true and the model is V5_5 (Discontinued), V6, V6_MINI, or V6_WILD.
image_urlsarrayImage references. Only effective when `custom_mode=false`. - Optional - Up to 5 images; each image must not exceed 10 MB - Supported formats: `jpeg`, `png`, `webp`, and `bmp`
varietynumberOnly available when Custom Mode (`custom_mode: true`) is enabled. Controls the diversity and stylistic variation of generated results. Optional. Range 0–4, integer, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different s Default: 1.
lyricsstringLyrics for the generated audio. Optional. - V6: Maximum 5000 characters. - When `custom_mode=true`, `lyrics` is used as lyrics first; if `lyrics` is not provided, `prompt` is used as lyrics. - When `custom_mode=false`, `lyrics` is used as a lyrics attachment and can be used together with the audio description in `prompt`.
audio_urlsarrayAudio references. Only effective when `custom_mode=false`. - Optional - Audio duration must be between 6 seconds and 30 minutes; each audio file must not exceed 500 MB
video_urlsarrayVideo references. Only effective when `custom_mode=false`. - Optional - Up to 1 video file; each file must not exceed 100 MB, duration must not exceed 241 seconds, with no minimum duration - Supported formats: mp4, mov, and webm
suno/generate-lyrics · Generate Lyrics · POST /v1/generations
FieldTypeDetails
prompt (required)stringDescription of the desired lyrics content. Be specific about theme, mood, style, or story elements you want in the lyrics. More detailed prompts yield better results. The maximum word limit is 200 characters.
suno/generate-midi-from-audio · Generate MIDI from Audio · POST /v1/generations
FieldTypeDetails
task_id (required)stringTask ID from a completed vocal separation. This should be the task_id returned from the Vocal & Instrument Stem Separation endpoint.
audio_idstringThe id of a stem from the separation callback (vocal_removal_info.origin_data[].id). If omitted, MIDI is generated from all stems.
suno/generate-persona · Generate Persona · POST /v1/generations
FieldTypeDetails
task_id (required)stringUnique identifier of the original music generation task. Generated by model suno/generate or suno/extend.
audio_id (required)stringUnique identifier of the audio track to create Persona for. This ID is returned in the webhook_url data after music generation completes.
name (required)stringName for the Persona. A descriptive name that captures the essence of the musical style or character.
description (required)stringDetailed description of the Persona's musical characteristics, style, and personality. Be specific about genre, mood, instrumentation, and vocal qualities.
vocal_startnumberStart time (in seconds) for Persona analysis segment extraction. Used to specify the time point in the audio from which to extract the segment for Persona analysis. Must be less than vocal_end, and vocal_end - vocal_start must be between 10–30 seconds. Defaults to 0.0. Default: 0.
vocal_endnumberEnd time (in seconds) for Persona analysis segment extraction. Together with vocal_start, used to specify the time range for analysis. vocal_end - vocal_start must be between 10–30 seconds. Defaults to 30.0. Default: 30.
stylestringOptional. Used to supplement the description of the music style tag corresponding to the Persona, such as "Electronic Pop", "Jazz Trio", etc.
suno/mashup · Generate Mashup Music · POST /v1/generations
FieldTypeDetails
upload_url_list (required)arrayArray of audio file URLs to mashup. Provide 2 audio URLs. Only the first 2 are used. Each URL must be publicly accessible.
promptstringA description of the desired audio content. Optional. - Used as lyrics only when `lyrics` is not provided. If `lyrics` is present, `prompt` is not used as lyrics. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters.
style (required)stringMusic style specification for the generated audio. Required. - Character limits by model: - **V4** (Discontinued): Maximum 200 characters - **V4_5 & V4_5PLUS** (Discontinued): Maximum 1000 characters - **V4_5ALL** (Discontinued): Maximum 1000 characters - **V5 & V5_5** (Discontinued): Maximum 1000 characters - **V6, V6_MINI & V6_WILD**: Maximum 1000 characters - Common examples: Jazz, Classical, E
title (required)stringTitle for the generated music track. Required. - Character limits by model: - **V4** (Discontinued): Maximum 80 characters - **V4_5 & V4_5PLUS** (Discontinued): Maximum 100 characters - **V4_5ALL** (Discontinued): Maximum 80 characters - **V5 & V5_5** (Discontinued): Maximum 100 characters - **V6, V6_MINI & V6_WILD**: Maximum 100 characters - Will be displayed in player interfaces and filenames.
model (required)stringRequired. Use V6, V6_MINI or V6_WILD. - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details. Allowed: V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5, V6, V6_WILD, V6_MINI.
vocal_genderstringVocal gender preference for the singing voice. Optional. Use 'm' for male and 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions. Allowed: m, f.
style_weightnumberStrength of adherence to the specified style. Optional. Range 0–1, up to 2 decimal places.
weirdness_constraintnumberControls experimental/creative deviation. Optional. Range 0–1, up to 2 decimal places.
audio_weightnumberBalance weight for audio features vs. other factors. Optional. Range 0–1, up to 2 decimal places.
durationintegerAudio duration in seconds. Optional. Range 10–360, default 20. Valid when `model` is ~~V5_5~~ (Discontinued), V6, V6_MINI, or V6_WILD. Default: 20.
lyricsstringLyrics for the mashup. Optional. - Takes priority over `prompt` as lyrics. If omitted, `prompt` is used as lyrics when provided. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters.
varietyintegerControls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encou Default: 1.
persona_idstringPersona ID or Voice ID to apply to the generated music. Optional. Use this to apply a specific persona style to your music generation. To generate a Persona ID, use the Generate Persona endpoint to create a personalized music Persona based on generated music. To generate a Voice ID, use the Generate Voice endpoint.
persona_modelstringPersona model. Optional. Use `style_persona` for Generate Persona IDs, or `voice_persona` for Suno Voice IDs. Default: `style_persona`. Available for V5 (Discontinued), V5_5 (Discontinued), V6, V6_MINI, and V6_WILD. Allowed: style_persona, voice_persona. Default: style_persona.
suno/regenerate-phrase · Suno Voice Regenerate Verification Phrase · POST /v1/generations
FieldTypeDetails
task_id (required)stringTask ID
suno/replace-section · Replace Music Section · POST /v1/generations
FieldTypeDetails
prompt (required)stringThe lyrics after replacement. Required.
tags (required)stringStyle tags for the music, such as jazz or electronic. Required.
title (required)stringThe title of the music. Required.
negative_tagsstringMusic styles to exclude, used to prevent specific stylistic elements from appearing in the replacement section.
infill_start_s (required)numberThe point in time, in seconds, at which replacement starts, rounded to 2 decimal places. Required. Must be less than infill_end_s, and the difference between infill_end_s and infill_start_s must be at least 10 seconds.
infill_end_s (required)numberThe point in time, in seconds, at which replacement ends, rounded to 2 decimal places. Required. Must be greater than infill_start_s, and the difference between infill_end_s and infill_start_s must be at least 10 seconds.
full_lyrics (required)stringThe complete modified lyrics, combining the modified and unmodified lyrics. Required. This parameter contains the complete lyrics text that will be used for the entire song after section replacement.
lyricsstringLyrics for the replaced segment. Optional. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters.
vocal_genderstringVocal gender preference. Optional. 'm' for male, 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions. Allowed: m, f.
style_weightnumberAdherence strength to specified style. Optional. Range 0–1, up to 2 decimal places.
weirdness_constraintnumberControls experimental/creative deviation level. Optional. Range 0–1, up to 2 decimal places.
audio_weightnumberRelative weight of audio elements. Optional. Range 0–1, up to 2 decimal places.
varietyintegerControls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encou Default: 1.
persona_idstringPersona ID or Voice ID to apply to the generated music. Optional. Use this to apply a specific persona style to your music generation. To generate a Persona ID, use the Generate Persona endpoint to create a personalized music Persona based on generated music. To generate a Voice ID, use the Generate Voice endpoint.
persona_modelstringPersona model. Optional. Use `style_persona` for Generate Persona IDs, or `voice_persona` for Suno Voice IDs. Default: `style_persona`. Available for V5 (Discontinued), V5_5 (Discontinued), V6, V6_MINI, and V6_WILD. Allowed: style_persona, voice_persona. Default: style_persona.
suno/separate-vocals · Vocal & Instrument Stem Separation · POST /v1/generations
FieldTypeDetails
typestringSeparation type, options: - **separate_vocal**: Separate vocals and accompaniment, generating a vocal track and an instrumental track. - **split_stem**: Separate various instrument sounds, generating multiple instrument tracks. - **split_stem_advanced**: Advanced multi-track separation, supporting the specification of a particular instrument track to generate finer instrument tracks. Allowed: separate_vocal, split_stem, split_stem_advanced. Default: separate_vocal.
stem_namestringOnly used when `type` is `split_stem_advanced` to request a specific stem track/instrument name.
suno/sounds · Generate sounds · POST /v1/generations
FieldTypeDetails
prompt (required)stringDescription of the sound (max 500 characters).
model (required)stringRequired. Use V6, V6_MINI or V6_WILD. - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details. Allowed: V5, V5_5, V6, V6_WILD, V6_MINI.
sound_loopbooleanWhether the generated sound loops seamlessly. Default: false.
sound_tempointegerTempo in BPM (1–300). Omit for automatic tempo.
sound_keystringMusical key. Default "Any" (automatic). Allowed: Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B. Default: Any.
grab_lyricsbooleanWhether to capture the lyrics subtitles Will the interface be called after completion to obtain the lyrics subtitles? Default: false.
suno/suno-recovery-audio · Recovery Audio · POST /v1/generations
FieldTypeDetails
task_id (required)stringThe original music generation task ID for which the audio link needs to be restored.
suno/timestamped-lyrics · Get Timestamped Lyrics · POST /v1/generations
FieldTypeDetails
task_id (required)stringUnique identifier of the music generation task. This should be a task_id returned from either the "Generate Music" or "Extend Music" endpoints.
audio_id (required)stringUnique identifier of the specific audio track for which to retrieve lyrics. This ID is returned in the webhook_url data after music generation completes.
suno/upload-and-cover-audio · Upload And Cover Audio · POST /v1/generations
FieldTypeDetails
upload_url (required)stringThe URL of the source audio file to cover. Required. Source audio (`upload_url`) is enough to generate. Ensure the uploaded audio does not exceed 8 minutes in length.
promptstringLyrics for the covered audio. Optional. - Used as lyrics only when `lyrics` is not provided. If `lyrics` is present, `prompt` is not used as lyrics. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`upload_url`) is enough to generate. - Do not pass this parameter when `instrumental` is `true`.
stylestringThe music style or genre for the audio. Optional. - Not required. Source audio (`upload_url`) is enough to generate. - Character limits by model: - **V4** (Discontinued): Maximum 200 characters - **V4_5 & V4_5PLUS** (Discontinued): Maximum 1000 characters - **V4_5ALL** (Discontinued): Maximum 1000 characters - **V5_5 & V5** (Discontinued): Maximum 1000 characters - **V6, V6_MINI, and V6_WILD**: Ma
titlestringThe title of the generated music track. Optional. - Maximum 80 characters. - Displayed in player interfaces and filenames.
instrumental (required)booleanDetermines if the audio should be instrumental (no lyrics). - If `true`: generate instrumental music (no vocals). Do not pass `lyrics`, `prompt`, or `vocal_gender`. - If `false`: use `lyrics` as lyrics (fall back to `prompt` if `lyrics` is not provided).
model (required)stringRequired. Use V6, V6_MINI or V6_WILD. - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details. Allowed: V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5, V6, V6_WILD, V6_MINI.
negative_tagsstringMusic styles or traits to exclude from the generated audio. - Optional. Use to avoid specific styles. Example: "Heavy Metal, Upbeat Drums"
vocal_genderstringVocal gender preference for the singing voice. Optional. Use 'm' for male and 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions. Do not pass this parameter when `instrumental` is `true`. Allowed: m, f.
style_weightnumberStrength of adherence to the specified style. Optional. Range 0–1, up to 2 decimal places.
weirdness_constraintnumberControls experimental/creative deviation. Optional. Range 0–1, up to 2 decimal places.
audio_weightnumberBalance weight for audio features vs. other factors. Optional. Range 0–1, up to 2 decimal places.
persona_idstringPersona ID or Voice ID to apply to the generated music. Optional. Use this to apply a specific persona style to your music generation. To generate a Persona ID, use the Generate Persona endpoint to create a personalized music Persona based on generated music. To generate a Voice ID, use the Generate Voice endpoint.
persona_modelstringPersona model: style_persona or voice_persona. Available for V6, V6_MINI and V6_WILD. Allowed: voice_persona, style_persona.
durationintegerTarget length in seconds (10–360). Optional; if omitted, the model chooses the length. Valid when `model` is ~~V5_5~~ (Discontinued), V6, V6_MINI, or V6_WILD.
lyricsstringLyrics for the covered audio. Optional. - Takes priority over `prompt` as lyrics. If omitted, `prompt` is used as lyrics when provided. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`upload_url`) is enough to generate. - Do not pass this parameter when `instrumental` is `true`.
varietyintegerControls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encou Default: 1.
suno/upload-and-extend-audio · Upload And Extend Audio · POST /v1/generations
FieldTypeDetails
upload_url (required)stringThe URL of the source audio file to extend. Required. Source audio (`upload_url`) is enough to generate. Ensure the uploaded audio does not exceed 8 minutes in length.
instrumentalbooleanDetermines whether the audio is instrumental (without lyrics). Optional; defaults to `false`. - If `true`: generate instrumental music (no vocals). Do not pass `lyrics`, `prompt`, or `vocal_gender`. - If `false`: use `lyrics` as lyrics (fall back to `prompt` if `lyrics` is not provided). Default: false.
promptstringLyrics for the extended audio. Optional. - Used as lyrics only when `lyrics` is not provided. If `lyrics` is present, `prompt` is not used as lyrics. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`upload_url`) is enough to generate. - Do not pass this parameter when `instrumental` is `true`.
stylestringMusic style, e.g., Jazz, Classical, Electronic. Optional. - Not required. Source audio (`upload_url`) is enough to generate. - Character limits by model: - **V6, V6_MINI & V6_WILD**: Maximum 1000 characters - **V5_5 & V5** (Discontinued): Maximum 1000 characters - **V4_5PLUS & V4_5** (Discontinued): Maximum 1000 characters - **V4_5ALL** (Discontinued): Maximum 1000 characters - **V4** (Discontinue
titlestringMusic title. Optional. - Maximum 100 characters. - Displayed in player interfaces and filenames.
continue_atnumberThe time point (in seconds) from which to start extending the music. - Value range: greater than 0 and less than the total duration of the uploaded audio. - Specifies the position in the original track where the extension should begin.
model (required)stringRequired. Use V6, V6_MINI or V6_WILD. - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details. Allowed: V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5, V6, V6_WILD, V6_MINI.
negative_tagsstringMusic styles to exclude from generation
vocal_genderstringVocal gender preference for the singing voice. Optional. Use 'm' for male and 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions. Do not pass this parameter when `instrumental` is `true`. Allowed: m, f.
style_weightnumberStrength of adherence to the specified style. Optional. Range 0–1, up to 2 decimal places.
weirdness_constraintnumberControls experimental/creative deviation. Optional. Range 0–1, up to 2 decimal places.
audio_weightnumberBalance weight for audio features vs. other factors. Optional. Range 0–1, up to 2 decimal places.
persona_idstringPersona ID or Voice ID to apply to the generated music. Optional. Use this to apply a specific persona style to your music generation. To generate a Persona ID, use the Generate Persona endpoint to create a personalized music Persona based on generated music. To generate a Voice ID, use the Generate Voice endpoint.
persona_modelstringThe persona model is only available for models version V5 (Discontinued), V5_5 (Discontinued), V6, V6_MINI, and V6_WILD. Allowed: style_persona, voice_persona.
lyricsstringLyrics for the extended audio. Optional. - Takes priority over `prompt` as lyrics. If omitted, `prompt` is used as lyrics when provided. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`upload_url`) is enough to generate. - Do not pass this parameter when `instrumental` is `true`.
varietyintegerControls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encou Default: 1.
suno/validation-phrase · Suno Voice Generate Verification Phrase API · POST /v1/generations
FieldTypeDetails
voice_url (required)stringThe original recording URL uploaded by the user [Required]
vocal_start_s (required)integerStart time (in seconds) for extracting the vocal segment [Required]
vocal_end_s (required)integerEnd time (in seconds) for extracting the vocal segment, must be greater than vocal_start_s [Required]
languagestringVerify the language of the short phrase. Supported languages ​​include: English (en), Chinese (zh), Spanish (es), French (fr), Portuguese (pt), German (de), Japanese (ja), Korean (ko), Hindi (hi), and Russian (ru).

Voice and audio endpoints

ModelEndpointWhat it does
voice-library-ttsPOST /v1/audio/speechText to speech with thousands of voices plus your cloned voices
voice-library-dialoguePOST /v1/audio/dialogueMulti-speaker dialogue
elevenlabs-scribePOST /v1/audio/transcriptionsSpeech to text with word timings
eleven_text_to_sound_v2POST /v1/audio/sound-effectsSound effects
suno-musicPOST /v1/audio/musicSongs from a description or your lyrics
eleven_multilingual_sts_v2POST /v1/audio/voice-changerSpeech to speech
voice-isolationPOST /v1/audio/voice-isolationBackground noise removal
dubbingPOST /v1/audio/dubbingDubbing into another language