Seedance Video

Seedance Video 使用官方兼容的视频任务接口。先创建任务，再通过任务查询接口轮询状态和最终视频地址。

接口地址

能力	方法	路径
统一创建视频任务	`POST`	`/v1/video/generations`
统一查询视频任务	`GET`	`/v1/video/generations/{task_id}`
官方兼容创建视频任务	`POST`	`/api/v3/contents/generations/tasks`
官方兼容查询视频任务	`GET`	`/api/v3/contents/generations/tasks/{task_id}`
审核图片	`POST`	`/v1/images/moderations`

支持模型

模型	说明
`doubao-seedance-2.0`	Seedance 2.0 标准模型

实际可用模型以账户权限和平台配置为准。

统一视频接口

统一视频接口适合和其他视频模型共用同一套调用方式。创建任务后，通过统一查询接口轮询状态和结果。

http

POST /v1/video/generations
GET /v1/video/generations/{task_id}

参数

参数	必填	说明
`model`	是	Seedance 模型名称，使用 `doubao-seedance-2.0`
`prompt`	是	视频生成描述
`seconds`	否	视频时长字符串，例如 `"5"`；也可以使用 `duration`
`images`	否	图片 URL 数组；需要参考图、首帧图时使用
`image`	否	单张图片 URL，等价于 `images` 的单图形式
`input_reference`	否	单个参考素材 URL，等价于单图输入
`metadata`	否	Seedance 扩展参数，会透传到任务请求体

常用 metadata 字段：

字段	说明
`resolution`	输出清晰度，如 `720p`、`1080p`；仅在所选模型支持时传入
`ratio`	画面比例，如 `16:9`、`9:16`、`1:1`
`duration`	视频时长，单位秒
`seed`	随机种子
`camera_fixed`	是否固定镜头
`watermark`	是否添加水印
`generate_audio`	是否生成音频
`content`	官方兼容内容数组；需要设置 `first_frame`、`last_frame`、`reference_image` 等素材角色时使用

文生视频示例

bash

curl -X POST https://cubicspaces.cloud/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedance-2.0",
    "prompt": "A cinematic aerial shot of a futuristic cubic city at sunrise",
    "seconds": "5",
    "metadata": {
      "resolution": "1080p",
      "ratio": "16:9",
      "watermark": false,
      "generate_audio": true
    }
  }'

参考图 / 首帧图示例

bash

curl -X POST https://cubicspaces.cloud/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedance-2.0",
    "prompt": "参考图片 1 的主体，让产品在干净影棚背景中缓慢旋转，保持主体外观一致。",
    "seconds": "5",
    "metadata": {
      "resolution": "720p",
      "ratio": "1:1",
      "camera_fixed": true,
      "watermark": false,
      "content": [
        {
          "type": "image_url",
          "image_url": {
            "url": "asset://reviewed-image-asset-id"
          },
          "role": "reference_image"
        }
      ]
    }
  }'

统一接口创建成功后返回标准视频任务对象：

json

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

查询任务：

bash

curl https://cubicspaces.cloud/v1/video/generations/video_xxx \
  -H "Authorization: Bearer YOUR_API_KEY"

完成后从响应的 metadata.url 读取视频地址。

官方兼容接口

http

POST /api/v3/contents/generations/tasks
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

参数

参数	必填	说明
`model`	是	Seedance 模型名称
`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，可使用公网视频或审核通过后的 `asset://<asset ID>`
`content[].role`	否	素材角色，如 `reference_image`、`first_frame`、`last_frame`
`duration`	否	视频时长，单位秒
`ratio`	否	画面比例，如 `16:9`、`9:16`、`1:1`
`seed`	否	随机种子
`camera_fixed`	否	是否固定镜头
`watermark`	否	是否添加水印
`generate_audio`	否	是否生成音频

请求示例

bash

curl -X POST https://cubicspaces.cloud/api/v3/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedance-2.0",
    "content": [
      {
        "type": "text",
        "text": "参考图片 1，生成 5 秒产品展示视频。"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "asset://reviewed-image-asset-id"
        },
        "role": "reference_image",
        "duration": 5
      }
    ],
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

创建成功会返回官方兼容任务对象，id 是任务 ID。返回中可能保留任务服务返回的其他字段，例如 service_tier、execution_expires_after 等：

json

{
  "id": "task_xxx",
  "model": "doubao-seedance-2.0",
  "status": "running",
  "created_at": 1770000000,
  "updated_at": 1770000000,
  "service_tier": "default",
  "execution_expires_after": 172800
}

审核图片

Seedance 使用真人或需要入库的图片素材时，先使用审核图片接口提交公开图片 URL。审核通过并入库后，将返回的 items[].asset_url 用作 content[].image_url.url。

http

POST /v1/images/moderations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

/v1/assets/moderations 也会走同一个审核处理逻辑。

请求参数

参数	必填	说明
`model`	是	用于选择 Seedance 渠道，建议传 `doubao-seedance-2.0`
`images`	否	图片 URL 数组
`image_urls`	否	图片 URL 数组，等价于 `images`
`image_url`	否	单张图片 URL
`asset_type`	否	资源类型，默认 `Image`；图片审核场景保持默认即可

images、image_urls、image_url 至少传一个。图片必须是公网可访问的 http 或 https URL，不支持 base64 或内联二进制内容。

审核限制

单次请求最多提交 50 个 URL；建议每次只提交 1 张图片，多张图片处理耗时更长。
同一批次只提交同一种素材类型；图片审核使用 asset_type: "Image"。
图片 URL 需要带有受支持的文件扩展名：.jpeg、.jpg、.png、.webp、.bmp、.tiff、.tif、.gif、.heic、.heif。
单张图片宽高比需在 0.4 到 2.5 之间，宽高建议在 300 到 6000 px 之间，文件大小小于 30 MB。
本接口是同步封装：系统会等待审核完成并返回统一结果；如处理超时，接口会继续轮询一段时间后再返回超时错误。

请求示例

bash

curl -X POST https://cubicspaces.cloud/v1/images/moderations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedance-2.0",
    "images": [
      "https://example.com/product.png"
    ]
  }'

返回示例

json

{
  "code": "success",
  "message": "",
  "data": {
    "object": "asset_moderation",
    "status": "approved",
    "review_batch_id": "review-batch-id",
    "task_id": "moderation-task-id",
    "items": [
      {
        "source_url": "https://example.com/product.png",
        "asset_url": "asset://reviewed-image-asset-id",
        "submit_review_status": 1,
        "passed": true
      }
    ]
  }
}

当 passed 为 true 且 submit_review_status 为 1 时，表示该图片审核通过。asset_url 通常是 asset://<asset ID> 形式；图生视频时将它放入 content，并设置 role，例如 reference_image、first_frame 或 last_frame。

提示词中引用素材时使用“图片 1”“图片 2”这种“素材类型 + 序号”格式，序号按 content 数组中同类素材出现顺序从 1 开始；不要在提示词里直接写 Asset ID。

旧素材系统的 asset 码不能直接用于 Seedance 2.0。请使用当前审核接口返回的 asset_url，或使用审核结果中的新素材 ID 拼接为 asset://<asset ID>。

文生视频示例

bash

curl -X POST https://cubicspaces.cloud/api/v3/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "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",
    "watermark": false
  }'

审核素材图生视频示例

bash

curl -X POST https://cubicspaces.cloud/api/v3/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedance-2.0",
    "content": [
      {
        "type": "text",
        "text": "参考图片 1 的主体，让产品在干净影棚背景中缓慢旋转，保持主体外观一致。"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "asset://reviewed-image-asset-id"
        },
        "role": "reference_image"
      }
    ],
    "duration": 5,
    "ratio": "1:1",
    "camera_fixed": true,
    "watermark": false
  }'

首尾帧示例

首尾帧分别使用 first_frame 和 last_frame 角色。素材可以是公网 URL，也可以是审核通过后的 asset://<asset ID>。

json

{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "根据图片 1 和图片 2 生成流畅过渡的视频。"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "asset://first-frame-asset-id"
      },
      "role": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "asset://last-frame-asset-id"
      },
      "role": "last_frame"
    }
  ],
  "duration": 8,
  "ratio": "16:9",
  "generate_audio": true
}

视频参考输入

Seedance 2.0 支持使用视频作为参考输入时，可以在 content 中传入 video_url。真人素材或授权素材也可以使用 asset://<asset ID>。

json

{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "Keep the character style and generate a new action sequence"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/reference.mp4"
      }
    }
  ],
  "duration": 5,
  "ratio": "16:9"
}

返回与查询

创建成功后保存 id，用于查询任务。

http

GET /api/v3/contents/generations/tasks/{task_id}
Authorization: Bearer YOUR_API_KEY

生成中通常返回：

json

{
  "id": "task_xxx",
  "model": "doubao-seedance-2.0",
  "status": "running",
  "created_at": 1770000000,
  "updated_at": 1770000030
}

任务完成后，查询响应会返回 status: "succeeded"，最终视频地址在 content.video_url：

json

{
  "id": "task_xxx",
  "model": "doubao-seedance-2.0",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated-video.mp4"
  },
  "created_at": 1770000000,
  "updated_at": 1770000600
}

任务失败时，查询响应会返回 status: "failed"，失败原因在 error.message：

json

{
  "id": "task_xxx",
  "model": "doubao-seedance-2.0",
  "status": "failed",
  "error": {
    "code": "task_failed",
    "message": "The request failed because the output video may be related to policy restrictions."
  },
  "created_at": 1770000000,
  "updated_at": 1770000300
}

控制台日志口径

Seedance 视频任务是异步任务。控制台使用日志中，退款类记录会区分为两种：

日志类型	说明
失败退款	任务最终失败时，退回该任务已占用的额度
预扣返还	任务成功后，系统按最终任务结果完成差额结算，返还多占用的部分

预扣返还 不代表视频任务失败。判断生成结果请以任务查询接口的 status、error.message 和 content.video_url 为准。

状态值

状态	说明
`queued`	排队中
`running`	生成中
`succeeded`	已完成
`failed`	失败，查看 `error.message`

注意事项

当前不支持 base64 图片或内联二进制素材；参考图、审核图都需要先上传到可公网访问的存储，再传 URL。
审核入库素材请使用 content 的 image_url / video_url / audio_url，URL 可传 asset://<asset ID>。
提示词引用素材请使用“图片 1 / 视频 1 / 音频 1”，不要直接使用 Asset ID。
当前文档展示 doubao-seedance-2.0；实际可用范围以账户权限和平台配置为准。
resolution 仅部分模型支持；不确定时不要传入。

Seedance Video ​

接口地址 ​

支持模型 ​

统一视频接口 ​

参数 ​

文生视频示例 ​

参考图 / 首帧图示例 ​

官方兼容接口 ​

参数 ​

请求示例 ​

审核图片 ​

请求参数 ​

审核限制 ​

请求示例 ​

返回示例 ​

文生视频示例 ​

审核素材图生视频示例 ​

首尾帧示例 ​

视频参考输入 ​

返回与查询 ​

控制台日志口径 ​

状态值 ​

注意事项 ​

Seedance Video

接口地址

支持模型

统一视频接口

参数

文生视频示例

参考图 / 首帧图示例

官方兼容接口

参数

请求示例

审核图片

请求参数

审核限制

请求示例

返回示例

文生视频示例

审核素材图生视频示例

首尾帧示例

视频参考输入

返回与查询

控制台日志口径

状态值

注意事项