Seedance 2.5 视频生成 API

文生视频（480p / 720p / 1080p）、首尾帧生成视频（480p / 720p）。接口为异步任务：先提交，再轮询取回 MP4 文件。

快速开始

接口说明

1. 提交任务 POST /v1/video/queue

返回（HTTP 200）：

{"request_id": "gen-vid-1793713035-eQOzBjp6ueTIHHDWdP6N", "status": "IN_QUEUE", "model": "seedance-2.5"}

额度不足以支付这条视频时返回 402 insufficient_quota，并说明所需和剩余金额。

2. 取回视频 POST /v1/video/retrieve

请求体：{"model": "seedance-2.5", "request_id": "<提交时返回的 request_id>"}

3. 查询额度 GET /v1/key

返回本 Key 的过期时间、人民币额度（quota.limit 总额度、spent 已用、in_progress 生成中占用、remaining 剩余）和当前单价 pricing。

4. 模型列表 GET /v1/models

返回可用模型及其支持的时长、分辨率、画面比例。

调用示例

curl

KEY="您的 API Key"

# 1. 提交
curl -s https://api.clankpt.com/v1/video/queue \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.5","prompt":"雪夜的京都小巷，一盏红灯笼在微风中摇晃，镜头缓慢推进","duration":5,"resolution":"720p","aspect_ratio":"16:9"}'
# => {"request_id":"gen-vid-...","status":"IN_QUEUE","model":"seedance-2.5"}

# 2. 轮询取回（完成时写入 out.mp4）
curl -s https://api.clankpt.com/v1/video/retrieve \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.5","request_id":"gen-vid-..."}' -o out.mp4 -w "%{content_type}\n"
# 输出 application/json 表示还在生成（out.mp4 里是 {"status":"processing"}），输出 video/mp4 表示已完成

Python

import time, requests

BASE = "https://api.clankpt.com"
H = {"Authorization": "Bearer 您的 API Key"}

job = requests.post(f"{BASE}/v1/video/queue", headers=H, json={
    "model": "seedance-2.5",
    "prompt": "雪夜的京都小巷，一盏红灯笼在微风中摇晃，镜头缓慢推进",
    "duration": 5, "resolution": "720p", "aspect_ratio": "16:9",
}, timeout=60)
job.raise_for_status()
rid = job.json()["request_id"]

deadline = time.time() + 15 * 60
while time.time() < deadline:
    r = requests.post(f"{BASE}/v1/video/retrieve", headers=H,
                      json={"model": "seedance-2.5", "request_id": rid}, timeout=300)
    if r.ok and r.headers.get("content-type", "").startswith("video/"):
        open(f"{rid}.mp4", "wb").write(r.content)
        print("saved", rid)
        break
    if not r.ok and r.status_code not in (429, 503):
        raise RuntimeError(r.text)
    time.sleep(8)

返回内容与画质

竖屏、方形等比例的总像素数与同档 16:9 基本相同，例如 720p 竖屏为 720 × 1280。

响应时间

• 提交任务：通常 1 秒内返回 request_id。
• 生成耗时（实测）：4 秒 480p 约 1 分钟；5 秒 720p 约 2 分钟；4 秒 1080p 约 2.5 分钟。时长越长、分辨率越高，耗时越长，1080p 预计最长约 7 分钟。
• 高峰期：模型方排队时可能需要 3 到 10 分钟。建议客户端总超时设为 15 分钟，轮询间隔 5 到 10 秒。
• 取回视频：完成后的那次 retrieve 会直接传输整个 MP4，720p 15 秒约 20 MB，下载时间取决于网络。

错误码

错误统一为 {"error": {"message": "...", "type": "...", "code": "..."}}。生成失败、未交付视频的任务不扣费。

如何鉴别是真的 Seedance 2.5

每个视频都内嵌了模型方签名的 C2PA 内容凭证（Content Credentials，AI 生成内容的国际标准溯源标识）。它由模型方在生成时用数字证书签名，第三方无法伪造，视频被重新编码或剪辑后凭证会失效。

验证方法

1. 在线验证（最简单）：打开 contentcredentials.org/verify，上传 MP4，查看签名方和模型信息，并确认签名状态为有效。
2. 命令行验证：用 C2PA 官方工具 c2patool 运行 c2patool out.mp4，检查 validation_state 和上表字段。
3. 快速粗查：strings out.mp4 | grep -i seedance 能看到 dreamina-seedance-2-5。这一步只能粗看，不能代替签名验证。

同时可以核对画质参数：1080p 应为 1920 × 1080，720p 应为 1280 × 720，均为 24 fps，时长与请求一致。

报价与计费

• 按请求的时长计费，与画面比例无关；是否生成音频不另收费。
• 只对成功交付的视频计费。排队、生成失败、取回时未拿到完整视频的任务都不扣费。
• 提交时会按“时长 × 单价”预留额度，剩余额度不足以支付这条视频时，任务会直接被拒绝，不会生成到一半失败。
• 试用额度：¥200，Key 有效期至 2026 年 12 月 3 日。GET /v1/key 和在线生成页面右上角均显示人民币剩余额度。

使用限制

• 分辨率：提供 480p、720p、1080p，不支持 2K / 4K。1080p 暂只支持文生视频（不支持首尾帧图片和随机种子），画面比例为 16:9、9:16、1:1、4:3、3:4、21:9。
• 1080p 编码：H.265（HEVC），部分浏览器无法在线播放，需下载观看。
• 时长：单条 4 到 30 秒，更长的视频需要分段生成后拼接。
• 内容审核：模型方对色情、暴力、政治敏感、真实人物（尤其公众人物）肖像、受版权保护的角色等内容有审核，相关提示词或首尾帧图片可能被拒绝或生成失败（不扣费）。
• AI 标识：视频内嵌 C2PA 内容凭证，标明为 AI 生成，且不可去除。在中国大陆发布 AI 生成视频需遵守《人工智能生成合成内容标识办法》，不得删除或篡改此类标识。
• 访问网络：服务部署在境外，中国大陆可直接访问，但速度受跨境网络影响，大文件下载可能较慢。
• 并发与稳定性：试用期间建议同时进行的任务不超过 5 个。生成速度受模型方排队影响，不承诺固定时长；大批量或长期使用请提前联系服务方。
• 首尾帧图片：image_url / end_image_url 需是公网可直接下载的图片地址，不支持上传本地文件。
• 视频保存：服务端不长期保存生成结果，取回后请自行保存。