文档中心 - TopenRouter

1 创建视频任务

Seedance-2.0 视频生成接口，支持通过文本、图片等输入生成视频。

POSThttps://tp-api.chinadatapay.com:8000/v1/video/tasks

用途：创建 Seedance 视频生成任务

请求示例

curl https://tp-api.chinadatapay.com:8000/v1/video/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
    "model": "doubao-seedance-2.0",
    "content": [
      {"type": "text", "text": "一只猫在海边奔跑，电影感，夕阳，4k"},
      {"type": "image_url", "image_url": {"url": "https://example.com/input.jpg"}, "role": "reference_image"}
    ],
    "ratio": "16:9",
    "duration": 4,
    "resolution": "720p",
    "execution_expires_after": 3600,
    "watermark": false
  }'

主要请求字段

字段	类型	必填	说明
`model`	string	是	视频生成模型 ID，例如 doubao-seedance-2.0
`content`	array	是	输入内容数组，支持文本、图片、视频、音频、样片任务 ID
`callback_url`	string	否	任务回调地址
`return_last_frame`	bool	否	是否返回尾帧
`generate_audio`	bool	否	是否生成同步音频
`draft`	bool	否	是否开启样片模式
`tools`	array/object	否	工具配置
`safety_identifier`	string	否	终端用户唯一标识
`execution_expires_after`	int	否	任务过期时间（秒）
`resolution`	string	否	视频分辨率，如 720p、1080p
`ratio`	string	否	宽高比，如 16:9、9:16
`duration`	int	否	视频时长（秒）
`seed`	int	否	随机种子
`watermark`	bool	否	是否带水印

content 结构

content 支持以下条目类型：

text - 文本
image_url - 图片
video_url - 视频
audio_url - 音频

并支持 role，例如：

reference_image - 参考图片
reference_video - 参考视频
reference_audio - 参考音频

响应示例

{ "id": "task_xxxxxx" }

2 查询单个任务

GEThttps://tp-api.chinadatapay.com:8000/v1/video/tasks/{id}

用途：查询单个视频生成任务详情

Headers

Content-Type: application/json
Authorization: Bearer $API_KEY

路径参数

字段	类型	说明
`id`	string	视频生成任务 ID

CURL 示例

curl https://tp-api.chinadatapay.com:8000/v1/video/tasks/task_xxxxxx \
  -H "Authorization: Bearer sk-xxxxxx"

状态说明

queued：排队中
running：运行中
cancelled：已取消
succeeded：成功
failed：失败
expired：超时

响应字段

字段	类型	说明
`id`	string	任务 ID
`model`	string	任务使用的模型名和版本
`status`	string	任务状态
`error`	object	错误信息，失败时返回
`created_at`	int64	创建时间
`updated_at`	int64	状态更新时间
`content`	object	输出内容，通常包含 video_url
`seed`	int	种子
`resolution`	string	分辨率
`ratio`	string	宽高比
`duration`	string/int	时长
`framespersecond`	int	帧率
`generate_audio`	bool	是否同步生成音频
`tools`	object	实际使用工具
`safety_identifier`	string	安全标识符
`draft`	bool	是否为 Draft 视频
`draft_task_id`	string	Draft 任务 ID
`execution_expires_after`	int	任务超时时间
`usage`	object	token 用量

成功响应示例

{
  "id": "cgt-2026xxxxxx",
  "model": "doubao-seedance-2.0",
  "status": "succeeded",
  "error": null,
  "created_at": 1718049470,
  "updated_at": 1718049870,
  "content": {
    "video_url": "https://example.com/video.mp4"
  },
  "seed": 12345,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 4,
  "framespersecond": 24,
  "generate_audio": false,
  "tools": {},
  "safety_identifier": "",
  "draft": false,
  "draft_task_id": "",
  "execution_expires_after": 3600,
  "usage": {
    "completion_tokens": 35800,
    "total_tokens": 35800
  }
}

失败响应示例

{
  "id": "cgt-2026xxxxxx",
  "model": "doubao-seedance-2.0",
  "status": "failed",
  "error": {
    "code": "OutputVideoSensitiveContentDetected",
    "message": "The request failed because the output video may contain sensitive information. Request ID: {id}"
  },
  "created_at": 1718049470,
  "updated_at": 1718049870
}

3 查询任务列表

GEThttps://tp-api.chinadatapay.com:8000/v1/video/tasks

用途：查询视频生成任务列表

CURL 示例

curl https://tp-api.chinadatapay.com:8000/v1/video/tasks \
  -H "Authorization: Bearer sk-xxxxxx"

4 上传素材接口（支持AIGC真人）

POSThttps://tp-api.chinadatapay.com:8000/v1/api/assets/upload

用途：将外部 URL 指向的素材（图片 / 视频 / 音频）上传到上游素材库，落库后获得稳定的 asset_id，可在创建视频任务时通过 content[].image_url.url 等字段引用。

请求头

Content-Type: application/json
Authorization: Bearer $ARK_API_KEY

必传 Query 参数

字段	类型	必填	说明
`model`	string	是	Seedance 模型名，例如 doubao-seedance-2.0

请求体字段

字段	类型	必填	说明
`url`	string	是	外部素材的 HTTP(S) URL（启用 SSRF 防护时必须为公网可达地址）
`asset_type`	string	是	Image / Video / Audio
`name`	string	否	自定义名称，便于在列表接口中按名称筛选

请求示例

curl -X POST 'https://tp-api.chinadatapay.com:8000/v1/api/assets/upload?model=doubao-seedance-2.0' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "url": "https://example.com/lion.jpg",
    "asset_type": "Image",
    "name": "lion01"
  }'

响应字段

字段	类型	说明
`code`	int/string	0 或 "success" 表示成功，非 0 表示失败
`message`	string	错误描述
`data.Id`	string	上游分配的 asset_id，形如 asset-20260507175358-hmw2h

响应示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "Id": "asset-20260507175358-hmw2h"
  }
}

错误说明

缺失 ?model ：HTTP 400
缺失 url / asset_type：HTTP 400
上游 URL 命中 SSRF 黑名单（启用 SSRF 防护时）：HTTP 400
上游接口失败：原样回传上游 HTTP 状态码与错误体

5 查询单个素材接口（支持AIGC真人）

GEThttps://tp-api.chinadatapay.com:8000/v1/api/assets/{asset_id}

用途：查询素材当前状态、签名 URL 等元信息

请求头

Authorization: Bearer $ARK_API_KEY

路径参数

字段	类型	必填	说明
`asset_id`	string	是	上传时返回的 data.Id，仅允许 [a-zA-Z0-9_\-]+

必传 Query 参数

字段	类型	必填	说明
`model`	string	是	Seedance 模型名，用于路由到对应渠道（与上传保持一致）

所有权语义

调用方必须是该 asset_id 的上传者（即上传时使用的 token 所属 user）。

命中：返回结果
未命中：返回 HTTP 404

请求示例

curl 'https://tp-api.chinadatapay.com:8000/v1/api/assets/asset-20260507175358-hmw2h?model=doubao-seedance-2.0' \
  -H "Authorization: Bearer $ARK_API_KEY"

响应字段

字段	类型	说明
`code`	int/string	0 或 "success" 表示成功
`message`	string	错误描述
`data.Id`	string	素材 ID
`data.Name`	string	自定义名称
`data.AssetType`	string	Image / Video / Audio
`data.Status`	string	上游状态：Active / Processing / Failed 等
`data.URL`	string	临时签名 URL（通常 12 小时过期，请按需重新查询）
`data.CreateTime`	string	创建时间

响应示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "Id": "asset-20260507175358-hmw2h",
    "Name": "lion01",
    "AssetType": "Image",
    "Status": "Active",
    "URL": "https://cdn.example.com/asset-...?Signature=...",
    "CreateTime": "2026-05-07T17:53:58Z"
  }
}

错误说明

asset_id 不符合 [a-zA-Z0-9_\-]+：HTTP 400
当前 token 不是该 asset_id 的上传者：HTTP 404
缺失 ?model ：HTTP 400

6 使用素材创建视频

当成功将素材上传至素材库中后，可使用 asset_id 创建视频任务。

⚠️ 注意：image_url 中的 url 参数是可通过 asset:// + asset_id 拼接的(真人参考图请优先使用该方式，否则可能触发敏感风控)，也可传入常规的 https 链接。

请求示例

{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "一只猫在海边奔跑，电影感，夕阳，4k"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "asset://asset-20260507175358-hmw2h"
      },
      "role": "reference_image"
    }
  ],
  "ratio": "16:9",
  "duration": 4,
  "resolution": "720p",
  "execution_expires_after": 3600,
  "watermark": false
}

7 计费规则

分辨率	含视频输入	不含视频输入
480P	28元/百万tokens	46元/百万tokens
720P	28元/百万tokens	46元/百万tokens
1080P	31元/百万tokens	51元/百万tokens

实际价格以模型广场为准