Seedance 视频生成接口

文档版本：v2.0　|　修订日期：2026-10-27　|　适用：intel-link.com
能力：文生视频（T2V）　|　形态：任务式异步（提交 → 轮询 → 取片）
本页由《RK_API_Seedance视频生成对接手册 v2.0》转换而来，内容以原文为准。

一、概览

接口采用任务式异步模型：先 POST 创建任务拿 task_id，再 GET 轮询任务状态，待 SUCCESS 后通过返回的 video_url 下载视频。

关键特性：创建接口只返回 task_id，实际生成需 1~3 分钟；video_url 限时有效（约 24 小时），请及时转存。

模型 ID

注：Seedance 2.0（doubao-seedance-2-0-260128）上游已不可用，调用返回 video_model_unavailable，暂不对外提供，请统一使用 2.5。

二、快速开始

1. 在 RK API 平台（intel-link.com）注册账号
2. 进入「API 密钥」页，创建令牌，复制 sk- 开头的密钥
3. 将 BaseURL 设为 https://intel-link.com，令牌作为 Bearer Token 使用

三步跑通：

1. 创建任务：POST /v1/video/generations
2. 轮询进度：GET /v1/video/generations/{task_id}
3. 下载视频：使用查询接口返回的 video_url 直接下载（限时有效）

三、接口详解

所有接口均需在请求头携带 Bearer 令牌。

3.1 创建视频生成任务

POST https://intel-link.com/v1/video/generations

请求头

请求体参数

size 取值与分辨率对应

• size 仅支持以上 4 个取值，其余任何尺寸都会被拒绝，返回 InvalidParameter
• 竖屏短视频用 720x1280；高画质宽幅用 1792x1024
• 分辨率无需单独传 resolution，平台按 size 自动推导
• 传 640x480、1920x1080 等会直接报错

响应

{
  "task_id": "task_t11xMcy7ka4DPTv7t8nqd1Q8xCZi8YnV",
  "status": "queued",
  "model": "doubao-seedance-2-5-260628",
  "created_at": 1793102708
}

创建成功即返回 task_id，请立即保存，后续轮询与取片都依赖它。

请求示例

curl -X POST https://intel-link.com/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "无人机极速穿越雪山峡谷，电影感运镜，光影自然",
    "size": "1280x720",
    "duration": 5
  }'

3.2 查询视频生成任务

GET https://intel-link.com/v1/video/generations/{task_id}

3.3 查询任务列表

GET https://intel-link.com/v1/video/generations

列表接口未纳入正式兼容承诺，长期方案请以本地保存 task_id 为准。

3.4 取消视频生成任务

平台当前未开放独立取消接口，如需中止请联系平台管理员。（本节保留占位，后续版本如开放取消能力将在此更新。）

3.5 下载视频内容

GET {video_url}（由查询接口返回，直接 GET 即可，无需鉴权头）

video_url 指向对象存储的 MP4 直链，限时有效（约 24 小时），请及时转存到自己的存储。

四、完整调用流程（Python 示例）

import time
import requests

BASE = "https://intel-link.com"
KEY  = "sk-你的RK平台令牌"
HEADERS = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

# Step 1：创建任务
resp = requests.post(
    f"{BASE}/v1/video/generations",
    headers=HEADERS,
    json={
        "model": "doubao-seedance-2-5-260628",
        "prompt": "一只金毛犬在海边奔跑，夕阳逆光，电影感慢镜头",
        "size": "1280x720",
        "duration": 5,
    },
)
task_id = resp.json()["task_id"]
print("任务 ID:", task_id)

# Step 2：轮询直到完成
while True:
    d = requests.get(
        f"{BASE}/v1/video/generations/{task_id}", headers=HEADERS
    ).json()["data"]
    print(d["status"], d["progress"])
    if d["status"] in ("SUCCESS", "FAILURE"):
        break
    time.sleep(5)

# Step 3：下载视频
if d["status"] == "SUCCESS":
    video_url = d["data"]["content"]["video_url"]
    open("output.mp4", "wb").write(requests.get(video_url).content)
    print("已保存 output.mp4")
else:
    print("生成失败:", d.get("fail_reason"))

五、错误码

平台侧错误码

视频任务错误信封

任务级错误统一通过 error 对象返回，便于程序判断。

• 成功：创建接口返回 {"task_id":"task_xxx","status":"queued",...}；查询接口返回 {"code":"success","data":{...}}
• 失败：常见 code 值 invalid_request / fail_to_fetch_task / plugin_usage_invalid / AccountOverdueError / video_model_unavailable

六、常见问题（FAQ）

任务与状态

创建任务返回 task_id 后，为什么还没有视频？
视频是异步生成，需要 1~3 分钟。请轮询 GET /v1/video/generations/{task_id}，直到 data.status 变为 SUCCESS。

视频链接打不开了？
生成视频链接限时有效（约 24 小时）。请生成完成后及时转存到自己的对象存储。

duration 传了 7 秒，为什么变成 5 秒？
平台对 duration 做归一：非 5 / 10 的值统一按 5 秒处理。

报错与参数

提示 InvalidParameter 怎么办？
最常见原因是 size 取值不合法。请严格使用 1280x720 / 720x1280 / 1792x1024 / 1024x1792 这 4 个值，其它尺寸会被拒绝并返回 plugin_usage_invalid 或 InvalidParameter。

返回 401 鉴权错误？
请依次检查：① 令牌是否以 sk- 开头；② 是否放在 Authorization: Bearer 头中；③ 令牌是否已被停用或额度耗尽。以上均正常仍报 401，请联系平台管理员。

想调整画面宽高比？
通过 size 控制：1280x720 为 16:9 横屏，720x1280 为 9:16 竖屏，1792x1024 为 7:4 宽幅，1024x1792 为 4:7 竖幅。

七、注意事项

• 令牌安全：sk- 令牌等同账号凭证，请勿泄露到客户端代码或公开仓库
• 及时转存：生成结果 URL 限时有效，生产环境请自动转存
• 并发与限流：视频生成耗时较长且按次预扣额度，建议控制并发，避免账户额度被瞬时占满
• 计费：按次计费，与 duration（5s / 10s）无关，但随分辨率档位变化；具体单价以平台「模型广场」实时价格为准
• 合规：请勿生成违法违规、侵犯他人权益的内容。平台对输入与输出内容有安全审核

八、版本记录