Seedance 2.0 / 2.5 视频生成

Server URLloading...

POST

/api/v3/contents/generations/tasks

Send

Authorization

Body

使用 Seedance 2.0 / 2.5 官方 content[] 格式创建异步视频生成任务。支持文生视频、图生视频、视频生视频、图像与音频组合、视频与音频组合，以及图像、视频、音频全模态引用。

素材支持自动上传。 在 content[].image_url.url、content[].video_url.url 或 content[].audio_url.url 中直接传入公网可访问的 https:// 链接，系统会自动识别并上传素材，无需提前调用 /api/assets/upload。

若希望使用 ModelSell 的通用视频格式，也可以调用 /v1/video/generations 或 /v1/videos，通过 prompt、image、images、metadata.video_url、metadata.audio_url 等字段提交。

需要通过素材 ID 复用图片、视频或音频时，也可以手动调用 /api/assets/upload 上传素材，素材状态为 Active 后可在 content[].*_url.url 中传入 asset://<asset_id>。 Seedance 2.5 新增 omni_reference_task_type，默认 auto，可选 reference、edit、extend。编辑要求 reference_video、ratio: adaptive 和 duration: -1；延长要求 reference_video 和 ratio: adaptive。完整约束与渠道差异见 请求与返回参数。

网关已部署草稿模式支持，实际可用性取决于所选渠道、上游账号和模型。尚未完成真实付费样片及正式片生成验证。第一步传 draft: true、resolution: 480p 创建 Seedance 2.5 样片。待样片成功后，第二步使用本用户的 ModelSell 公共任务 ID：content 只含一个 {"type":"draft_task","draft_task":{"id":"task_…"}}，model 与样片一致，resolution 省略或为 1080p，draft 省略或为 false。网关自动转换上游引用 ID 并沿用原渠道账号；不要直接传 cgt-… 或 mvt-…。

正式片自动复用样片的提示词、参考媒体、duration、ratio、seed、generate_audio、omni_reference_task_type，禁止再次显式传入。可重新指定 return_last_frame、output_format、watermark、service_tier、execution_expires_after、priority、callback_url、safety_identifier；省略时使用模型默认值，2.5 不支持 service_tier: flex。样片 ID 从 created_at 起 7 天有效，需成功完成才能引用。两步独立计费，正式片的输入视频类别和时长沿用第一步，样片产物本身不计作输入视频。

样片字段依据 2026-10-09 核对的 官方创建 API 与 Seedance 2.5 样片教程。

官方字段已于 2026-09-07 核对 https://docs.volcengine.com/docs/82379/1520757 和 https://docs.volcengine.com/docs/82379/1521309。高级字段需所选渠道支持，通用格式不能假定透传全部原生字段。

Response Body

curl -X POST "https://example.com/api/v3/contents/generations/tasks" \  -H "Content-Type: application/json" \  -d '{    "model": "doubao-seedance-2-5-260628",    "content": [      {        "type": "text",        "text": "一只橘猫在阳光下的花园里追逐蝴蝶，镜头平稳跟随。"      }    ],    "draft": true,    "resolution": "480p",    "duration": 5,    "ratio": "16:9"  }'

{
  "id": "task_UPUfjg0S3UXekH2OgTZBXyqgGhsxgkp6"
}

{
  "error": {
    "code": "InvalidParameter.TaskTypeMismatch",
    "message": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}