Query task (Seedance)

This series supports OpenAI video generation formats (see the link Video generation Sora compatible formats).

Used to create video generation tasks and query status and results via task ID.

Core fields for task creation:

• model: Required. Model name.
• prompt: Required. Primary description for video generation.
• content: Optional, the Volcano Ark content array, mixing text, image, video, and audio materials.
• function_mode: Optional. Commonly used for advanced modes such as Omni-Reference.

Compatible input parameters:

• mode：t2v / i2v / i2v_first_last / reference_images / reference_material
• image_url / image_urls / input_reference
• end_image_url / last_image_url
• video_urls / audio_urls
• seconds / duration
• aspect_ratio / ratio / size
• quality / resolution
• fps
• generate_audio / watermark

Call details:

• When using mode=reference_material or function_mode=omni_reference, it is recommended to pass text and reference materials via content.
• content text items are written as { "type": "text", "text": "测试文字" }.
• content image, video, and audio material items use the image_url, video_url, and audio_url object formats respectively, for example { "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }.
• role can be used to identify the purpose of the material, and name can be referenced by name in prompts.
• ratio, duration, resolution, and fps will affect the final generation configuration.

Gemini Omni invocation:

• gemini-omni can also be invoked through this Seedance task API.
• mode=t2v is used for text-to-video, mode=r2v for generation with reference images/reference materials, and mode=edit for video editing.
• Text can be placed in the text item of prompt or content; images can be placed in image_url / image_urls / reference_images / input_reference / content; videos can be placed in video_urls / content.
• The duration field can use duration or seconds, and will be automatically mapped to the 4 / 6 / 8 / 10 second options.

Key fields in query results:

• items[].status
• items[].content.video_url or items[].video_url
• items[].error
• items[].progress

Error fields: error.code, error.message.

{
"error": {
"code": "invalid_request_error",
"message": "requires at least one image in `images`"
}
}