字节 Seedance / 概览#

Seedance 是字节的视频生成模型，通过视频域名上的异步任务接口调用。

前置条件#

• 已获取 UniGateway API Key，保存在 UNIGATEWAY_API_KEY 中

UNIGATEWAY_API_KEY=<YOUR_UNIGATEWAY_API_KEY>

鉴权#

所有 Seedance 接口使用 Bearer Token：

Authorization: Bearer $UNIGATEWAY_API_KEY

接口说明#

视频生成接口#

素材库接口#

查找可用模型#

Seedance 模型在视频域名上，不通过 /v1/models：

curl https://video.unigateway.ai/api/models \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY"

示例模型 — 以实时查询为准：

调用流程#

创建任务#

curl -sS -X POST "https://video.unigateway.ai/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-fast",
    "content": [
      { "type": "text", "text": "天空飘着一朵白云。" }
    ],
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": false
  }'

响应：

{
  "id": "cgt-20260514135903-68khw"
}

查询状态#

curl -sS "https://video.unigateway.ai/api/v3/contents/generations/tasks/{id}" \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY"

响应（处理中）：

{
  "id": "cgt-20260514135903-68khw",
  "model": "doubao-seedance-2.0-fast",
  "status": "running",
  "content": {},
  "usage": null
}

响应（已完成）：

{
  "id": "cgt-20260514135903-68khw",
  "model": "doubao-seedance-2.0-fast",
  "status": "succeeded",
  "content": {
    "video_url": "https://<your-cdn>/media/output/video.mp4"
  },
  "usage": {
    "billing_mode": "credits",
    "credits": 50
  }
}

查询任务列表#

curl -sS "https://video.unigateway.ai/api/v3/contents/generations/tasks?page_num=1&page_size=20" \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY"

返回近 7 天任务。可选过滤：filter.status、filter.task_ids、filter.model。

取消任务#

curl -sS -X DELETE "https://video.unigateway.ai/api/v3/contents/generations/tasks/{id}" \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY"

排队中的任务可被取消。正在运行或已完成的任务无法删除。

任务状态#

参数说明（创建）#

部分参数不是所有模型变体都支持，请逐一测试。

轮询策略#

• 创建后 2-3 秒首次查询
• 随等待时间增长逐步拉大间隔（3s -> 5s -> 10s）
• 在调用方设置总超时
• 不对同一任务 ID 高频并发查询

常见错误#

详细接口参考：创建任务、查询任务、素材库。