查询任务(Seedance)
视频生成Seedance格式
查询任务(Seedance)
该系列支持OpenAI视频生成格式(详见链接 视频生成Sora兼容格式)。
用于创建视频生成任务,并通过任务 ID 查询状态与结果。
创建任务核心字段:
model:必填,模型名称。prompt:必填,视频生成主描述。content:可选,火山方舟 content 数组,混排文本、图片、视频、音频素材。function_mode:可选,常用于全能参考等高级模式。
兼容入参:
mode:t2v / i2v / i2v_first_last / reference_images / reference_materialimage_url / image_urls / input_referenceend_image_url / last_image_urlvideo_urls / audio_urlsseconds / durationaspect_ratio / ratio / sizequality / resolutionfpsgenerate_audio / watermark
调用细节:
- 当
mode=reference_material或function_mode=omni_reference时,建议通过content传递文本与参考素材。 content文本项写法为{ "type": "text", "text": "测试文字" }。content图片、视频、音频素材项分别使用image_url、video_url、audio_url对象写法,例如{ "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }。role可标识素材用途,name可供提示词中按名称引用。ratio、duration、resolution、fps会影响最终生成配置。
Gemini Omni 调用:
gemini-omni也可通过本 Seedance 任务接口调用。mode=t2v用于文生视频,mode=r2v用于参考图/参考素材生成,mode=edit用于视频编辑。- 文本可放在
prompt或content的text项;图片可放在image_url / image_urls / reference_images / input_reference / content;视频可放在video_urls / content。 - 时长字段可用
duration或seconds,会自动匹配到 4 / 6 / 8 / 10 秒档。
查询结果关注字段:
items[].statusitems[].content.video_url或items[].video_urlitems[].erroritems[].progress
Error fields: error.code, error.message.
{
"error": {
"code": "invalid_request_error",
"message": "requires at least one image in `images`"
}
}
GET
查询任务(Seedance)
授权
使用 Bearer Token 认证。
格式: Authorization: Bearer sk-xxxxxx
路径参数
?? ID
