简体中文

English

简体中文

English

主题

Seedance 视频生成 ​

Seedance 2.0 通过官方生成入口提交异步视频任务，支持文生视频、首帧/首尾帧、参考图/视频/音频、视频延续、视频编辑与多模态合成等模式。

http
POST /v1/video/generations

素材库资产在 中可用 引用。任务提交成功后返回 task_id，用 任务查询 轮询。

当前可用模型 ​

请求头 ​

名称类型必填说明
string是请求身份认证。使用 Bearer Token，示例：
string是请求内容类型，必须设置为

请求体 ​

名称类型必填说明
string是模型名称
array<object>是多模态输入数组，顺序影响角色分配
object否视频生成参数，均可选

content 内容项 ​

名称类型必填说明
string是内容类型：、、、、
string条件 时必填，提示词文本
string条件 时必填，图片公网 URL 或
string条件 时必填，视频公网 URL 或素材引用
string条件 时必填，音频公网 URL 或素材引用
string条件 时必填，草稿任务 ID（须为 content 唯一元素）
string否媒体角色：（首帧）、（尾帧）、（参考图）、（参考/源视频）、（参考音频，须 ）

metadata ​

名称类型必填说明
integer否时长（秒），合法范围 – 或 （模型自动决定），默认
string否、、、，默认
string否、、、、，默认
integer否总帧数；与 二选一，传了优先于 duration
integer否随机种子，相同 seed + 相同输入可得相近结果
boolean否固定机位（抑制镜头运动），默认
boolean否右下角水印，默认
boolean否生成/合成音频；使用 时必须为 ，默认
boolean否返回末帧图片 URL 便于续写，默认
boolean否草稿模式（更快、质量略低），默认
string否服务等级，默认
integer否最长执行时间（秒），范围 –，默认
string否完成回调 URL

生成模式对照 ​

模式content 要点
文生视频 + 可选参考图/视频/音频
首帧图生视频 +
首尾帧生视频 + +
参考图生视频 +
视频延续 +
视频编辑 + +
多模态合成 + 多类型参考组合
引用素材库各 URL 使用

请求示例 ​

json
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "第一人称视角果茶广告：0-2秒 手摘苹果；2-4秒 切镜头投入雪克杯摇晃"
    },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/apple.jpg" },
      "role": "reference_image"
    }
  ],
  "metadata": {
    "duration": 8,
    "resolution": "720p",
    "ratio": "16:9"
  }
}
json
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "Animate naturally from the first frame"
    },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/first.jpg" },
      "role": "first_frame"
    }
  ],
  "metadata": {
    "duration": 10,
    "resolution": "720p",
    "ratio": "adaptive"
  }
}
json
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "第一人称视角果茶广告"
    },
    {
      "type": "image_url",
      "image_url": { "url": "asset://asset-xxx" },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": { "url": "asset://asset-xxx" },
      "role": "reference_video"
    }
  ],
  "metadata": {
    "duration": 8,
    "resolution": "720p",
    "ratio": "16:9"
  }
}

响应示例 ​

json
{
  "task_id": "cgt-20260412163502-x8k2m"
}

响应字段 ​

名称类型说明
string任务 ID，用于任务查询

注意事项 ​

WARNING

content 混用规则（违反可能返回 400）：

  • 不能与 / 同时出现；
  • 不能作为 content 中唯一输入，须至少搭配图片或视频；
  • 必须是 content 数组里的唯一元素。

素材库（Asset） ​

主入口 中的 引用素材库资源。使用流程：

  1. 创建素材组，取得 GroupId；
  2. 将公网 HTTPS 素材导入该组（异步转码 / 审核），取得 task_id；
  3. 轮询素材状态至可引用后，用返回的 AssetId 在视频请求中引用。

创建素材组（POST /v1/seedance/asset/CreateAssetGroup） ​

名称类型必填说明
string是素材组名称，最长 64 字符
string否素材组描述，最长 300 字符
bash
curl -X POST https://octopusx.ai/v1/seedance/asset/CreateAssetGroup \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "Name": "test",
  "Description": "this is description"
}'

导入素材（POST /v1/seedance/asset/CreateAsset） ​

名称类型必填说明
string是素材组 ID，来自创建素材组返回的 data.Id
string是待导入素材的公网 HTTPS 地址
string是素材类型：、、
string是素材名称

导入成功后返回 AssetId，视频请求中推荐用 引用，而不是重复填写公网 URL。

查询素材（POST /v1/seedance/asset/GetAsset） ​

名称类型必填说明
string是导入素材时返回的任务 ID

轮询素材处理进度与详情，素材可引用后即可用于生成请求。

相关接口 ​