Seedance 概览#

Seedance 视频生成通过 UniGateway API 域名下的异步任务接口调用。

前置条件#

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

UNIGATEWAY_API_KEY=<your-api-key>

鉴权#

通过 Bearer Token 发送 API Key：

Authorization: Bearer $UNIGATEWAY_API_KEY

Base URL#

BASE_URL=https://api.unigateway.ai

接口#

视频生成#

素材库#

查找可用模型#

通过模型库或模型接口查询账号可用的模型 ID：

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

示例模型 ID，以账号实时可用结果为准：

接入建议#

普通文生视频或图生视频场景通常只需要使用视频生成接口。

需要素材审核、白名单素材、可复用角色/场景参考图，或围绕同一组审核素材持续生成时，再接入素材库接口。如果内容不涉及敏感素材、真人、明星、数字人、版权角色或可复用参考素材，通常不需要素材库流程。

任务流程#

创建任务#

curl -sS -X POST "https://api.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-260128",
    "content": [
      { "type": "text", "text": "天空飘着一朵白云。" }
    ],
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": false
  }'

响应：

{
  "id": "task_123456"
}

查询任务#

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

执行中响应：

{
  "id": "task_123456",
  "model": "doubao-seedance-2-0-fast-260128",
  "status": "running",
  "content": {},
  "usage": {
    "billing_mode": "quota",
    "charged_quota": 875000
  },
  "created_at": 1781255171,
  "updated_at": 1781255181,
  "progress": "50%",
  "service_tier": "default",
  "generate_audio": false
}

完成响应：

{
  "id": "task_123456",
  "model": "doubao-seedance-2-0-fast-260128",
  "status": "succeeded",
  "content": {
    "video_url": "https://video.demo.url"
  },
  "usage": {
    "billing_mode": "token",
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1781255171,
  "updated_at": 1781255427,
  "completed_at": 1781255427,
  "progress": "100%",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "service_tier": "default",
  "generate_audio": false
}

查询任务列表#

curl -sS "https://api.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、filter.service_tier。

删除任务#

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

排队中的任务会被取消并返回 {}。运行中的任务不能删除。已完成任务删除成功时返回 {}。

任务状态#

审核相关失败可能同时返回 presentation_status 和 presentation_reason，此时原始任务 status 可能仍为 failed。

创建参数#

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