创建视频

统一视频接口用于提交异步视频生成任务。新接入推荐使用官方风格的顶层 content 数组，文本、图片、视频、音频都放在同一个数组里。

请求地址

POST /v1/video/generations

推荐写法：官方 content

content 是多模态内容数组。文本、图片、视频、音频都放在同一个数组里，通过 type 区分素材类型，通过 role 区分素材用途。

文生视频

{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "A cinematic aerial shot of a futuristic cubic city at sunrise"
    }
  ],
  "duration": 5,
  "ratio": "16:9",
  "generate_audio": false,
  "watermark": false
}

单图生成视频

{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "让图片 1 中的人物自然转身，电影感镜头"
    },
    {
      "type": "image_url",
      "role": "first_frame",
      "image_url": {
        "url": "https://example.com/input.jpg"
      }
    }
  ],
  "duration": 5,
  "ratio": "16:9"
}

首尾帧视频

{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "从图片 1 自然过渡到图片 2"
    },
    {
      "type": "image_url",
      "role": "first_frame",
      "image_url": {
        "url": "https://example.com/start.jpg"
      }
    },
    {
      "type": "image_url",
      "role": "last_frame",
      "image_url": {
        "url": "https://example.com/end.jpg"
      }
    }
  ],
  "duration": 5,
  "ratio": "16:9"
}

多模态参考

{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "参考图片 1、视频 1 和音频 1，生成一段产品展示视频"
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "asset://reviewed-image-asset-id"
      }
    },
    {
      "type": "video_url",
      "role": "reference_video",
      "video_url": {
        "url": "https://example.com/reference.mp4"
      }
    },
    {
      "type": "audio_url",
      "role": "reference_audio",
      "audio_url": {
        "url": "https://example.com/reference.wav"
      }
    }
  ],
  "duration": 5,
  "ratio": "1:1",
  "generate_audio": true
}

顶层字段

字段	必填	说明
model	是	视频模型名，例如 doubao-seedance-2.0、doubao-seedance-2.0-fast
content	推荐	官方风格多模态内容数组。推荐新接入使用
duration	否	视频时长，整数秒。Seedance 2.0 常用范围为 4 到 15，默认通常为 5
ratio	否	输出比例，例如 adaptive、16:9、9:16、1:1、4:3、3:4、21:9
resolution	否	输出分辨率，例如 480p、720p、1080p。具体支持以模型和账号权限为准
generate_audio	否	是否生成同步音频，布尔值
watermark	否	是否添加水印，布尔值

content 格式

字段	必填	说明
content[].type	是	text、image_url、video_url、audio_url
content[].text	条件必填	type 为 text 时使用
content[].image_url.url	条件必填	图片公网 URL，或图片审核通过后的 asset://<asset ID>
content[].video_url.url	条件必填	视频公网 URL
content[].audio_url.url	条件必填	音频公网 URL
content[].role	条件必填	素材角色，见下方 role 表

可用 role：

素材	role
图片	first_frame、last_frame、reference_image
视频	reference_video
音频	reference_audio

素材限制

• 当前公开接口不支持在请求中直接传 base64 或内联二进制素材。
• 图片、视频、音频 URL 必须能被平台服务端直接访问，不要使用需要登录、会跳转到 HTML 页面、或限制防盗链的地址。
• 图片参考最多 9 张。
• 视频参考最多 3 个，单个视频最长建议 15 秒，所有参考视频总时长不超过 15 秒。
• 音频参考最多 3 个，单个音频最长建议 15 秒，所有参考音频总时长不超过 15 秒。
• 音频不能单独作为唯一素材，至少同时提供 1 个图片或视频素材。
• 首帧/首尾帧场景不要和 reference_image、reference_video、reference_audio 混用。

真人图片和审核

如果输入图片包含真人或隐私信息，上游可能返回类似 PrivacyInformation 的内容安全错误。需要稳定使用这类素材时，请先调用图片审核接口：

POST /v1/images/moderations

审核通过后，将返回的 items[].asset_url 放到 content[].image_url.url 中。

返回

创建成功后返回任务 ID：

{
  "id": "video_xxx",
  "task_id": "video_xxx",
  "object": "video",
  "model": "doubao-seedance-2.0",
  "status": "queued",
  "created_at": 1770000000
}

查询任务：

GET /v1/video/generations/{task_id}

完成后从查询响应中的视频 URL 字段读取结果，具体字段以模型页说明为准。