概览
这些接口面向已经使用火山风格 Seedance 任务结构的团队。它们保留任务式请求和响应结构,同时使用 AI Sonar 的鉴权、计费、模型可用性和任务轮询。 另见 Seedance 2.0 视频模型 和 视频生成。鉴权与入口
- 使用
Authorization: Bearer <API_KEY>。 - 当前版本不接受火山 AK/SK 签名。只带 AK/SK 签名而没有 AI Sonar Bearer 的请求会返回火山风格鉴权错误。
Version可省略;如传入,必须为2024-01-01。
内容规则
type: "text"表示提示词文本。type: "image_url"不传role或传role: "first_frame"时按首帧处理。role: "last_frame"必须和首帧一起使用。role: "reference_image"、reference_video、reference_audio表示参考素材。image_url.url可以是公网图片 URL,也可以是asset://asset-YYYYMMDDHHMMSS-xxxxx形式的 AI Sonar 素材 URI;role决定该素材是首帧、尾帧还是参考图。- AI Sonar 额外兼容一个顶层
material_asset_id,并将其按首帧处理。多个顶层material_asset_ids因用途不明确会被拒绝;请改放到content[]中并为每个素材明确填写role。 - 同一个请求里不要混用首尾帧输入和参考素材。
参数说明
ratio支持16:9、4:3、1:1、3:4、9:16、21:9或adaptive。duration表示秒数,也支持模型允许的自动时长值。resolution可传480p、720p、1080p或4k,以前提是所选 Seedance 模型支持。generate_audio默认是true;需要静音视频时传false。watermark、return_last_frame、seed、priority、execution_expires_after和safety_identifier在符合所选模型规则时可用。callback_url暂不支持;请轮询任务状态。
图片准备
content[] 中包含图片 URL 时,AI Sonar 会在所选 Seedance 模型需要素材引用时把它们准备为可复用素材。如果 60 秒内仍未准备完成,创建请求会返回可重试的素材准备中错误,而不是提交一个不完整的视频任务。
使用已有 AI Sonar 素材时,请传公开的 asset-YYYYMMDDHHMMSS-xxxxx ID,不要传其他系统返回的原始素材 ID。AI Sonar 会在生成前校验素材归属。
创建响应
示例
REST 创建
content[] 只包含文本,并额外传入:
content[] 并明确用途:
Action 创建
下一步
使用返回的cgt-... ID 调用 查询任务(火山兼容),直到任务进入终态。