多模型 异步任务

视频生成 API

对接速查(主站 / 客户端用)
接口地址https://independent.172-247-37-6.sslip.io
鉴权Authorization: Bearer sk-…(在网关「令牌」页创建)
查模型GET /v1/models → 返回 seedance-2.5-wr-ref / seedance-2.0-wr-ref
提交POST /v1/videos → 返回 {"id":"task_…","status":"queued"}
轮询GET /v1/videos/{id} → status 为 queued / in_progress / completed / failed;completed 取 video_url
取文件GET /v1/videos/{id}/content → video/mp4 字节流
参数固定为 model / prompt / seconds / resolution / ratio + 可选 reference_images / reference_videos / reference_audios;不走流式,异步任务。

统一的视频生成请求格式:一段提示词,加上可选的参考图片、视频、音频。本文档只定义怎么请求,不对任何单一模型做限制——当前可用的模型与各自参数见第 3 节。供应商切换、密钥轮询、失败重试由网关处理。

1. 快速开始

三步跑通,大约 5 分钟。

  1. 向管理员申请令牌,格式为 sk- 开头
  2. 调用 POST /v1/videos 提交任务,拿到 task id
  3. 轮询 GET /v1/videos/{id},状态为 completed 时用 video_url 下载
curl -X POST https://independent.172-247-37-6.sslip.io/v1/videos \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-wr-ref",
    "prompt": "一只橘猫在月夜屋顶上转身拔剑",
    "seconds": 4,
    "resolution": "480p",
    "ratio": "9:16"
  }'
生成是异步的:4 秒片段约 3–4 分钟,30 秒片段约 5 分钟。请不要同步等待,用轮询。

2. 认证

项值
Base URLhttps://independent.172-247-37-6.sslip.io
认证方式Authorization: Bearer sk-xxxxxxxx
内容类型application/json

3. 可用模型与各自限制

下面这些模型共用同一套请求格式,只是时长、素材上限和线路不同。同名模型有两条独立线路,后缀 -at 的走 Atlas,不带后缀的走 RunAPI,你可以按质量和成本自行选择;两条线路的请求写法完全一样。上限由网关在提交前校验,超限直接返回 400,不扣费。

model时长参考图参考视频参考音频线路
seedance-2.5-wr-ref4–30 秒≤ 30≤ 10≤ 10RunAPI 线路
seedance-2.0-wr-ref4–15 秒≤ 9≤ 3≤ 3RunAPI 线路
seedance-2.5-wr-ref4–30 秒≤ 30≤ 10≤ 10Atlas 线路
seedance-2.0-wr-ref4–15 秒≤ 9≤ 3≤ 3Atlas 线路

支持画幅:16:9 9:16 1:1 4:3 3:4 21:9(另有 adaptive 跟随参考素材比例)。实际像素由「分辨率档位 + 画幅」决定,短边等于档位像素。

注意:seconds 的上限跟着模型走。seedance-2.0-wr-ref 传 16 秒会被拒绝, seedance-2.5-wr-ref 可以到 30 秒。素材数量同理。

4. 创建任务

POST /v1/videos

4.1 字段总表

字段类型必填默认说明
modelstring是—模型 id,取第 3 节列出的值(如 seedance-2.5-wr-ref)。网关按你传的 id 路由,不做白名单限制
promptstring是—画面描述,最多 20480 字符
resolutionstring是—480p / 720p(1080p 暂未开放)
secondsnumber否54–30 整数,或 -1 由模型决定
ratiostring否9:1616:9 9:16 1:1 4:3 3:4 21:9 adaptive
reference_imagesarray否—参考图 URL,最多 30 张
reference_videosarray否—参考视频 URL,最多 10 个
reference_audiosarray否—参考音频 URL,最多 10 个
别名(等价):duration 等同于 seconds;image / images / input_reference 等同于单张参考图; video 等同于单个参考视频;audio 等同于单个参考音频。
音频始终生成:模型原生同步生成音频,不支持关闭;也不要再传 generate_audio 或 return_last_frame,这两个字段已从接口移除。

4.2 完整请求

{
  "model": "seedance-2.5-wr-ref",
  "prompt": "@Image1 中的猫咪穿上盔甲,动作参考 @Video1,声音参考 @Audio1",
  "seconds": 4,
  "resolution": "480p",
  "ratio": "9:16",
  "reference_images": ["https://你的图/cat.png"],
  "reference_videos": ["https://你的视频/move.mp4"],
  "reference_audios": ["https://你的音频/voice.mp3"]
}

4.3 响应

{
  "id": "task_xxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "seedance-2.5-wr-ref",
  "status": "queued",
  "progress": 0,
  "created_at": 1793420998
}

5. 素材要求

所有参考素材都必须是公网可访问的 URL,不支持上传文件。数量上限随模型不同,先看第 3 节。

图片 reference_images

项限制
张数2.5 系(含 -at)≤ 30 / 2.0 系 ≤ 9
格式jpeg / png / webp / bmp / tiff / gif / heic / heif
边长300 – 6000 px
宽高比0.4 – 2.5
单张大小< 30 MB

视频 reference_videos

项限制
数量2.5 系 ≤ 10 / 2.0 系 ≤ 3
格式mp4 / mov(H.264 / H.265 + AAC / MP3)
时长单段 2 – 30 秒;全部合计 ≤ 30 秒
分辨率480p – 4K
帧率24 – 60 fps
单个大小≤ 200 MB

音频 reference_audios

项限制
数量2.5 系 ≤ 10 / 2.0 系 ≤ 3
格式wav / mp3
时长单段 2 – 30 秒;全部合计 ≤ 30 秒
单个大小≤ 15 MB
素材时长、格式、大小由上游校验。不合规会在提交阶段返回 400,不扣费。

6. @ 引用规则

写法指向
@Image1 / @Image2reference_images 数组第 1 / 2 张
@Video1reference_videos 数组第 1 个
@Audio1reference_audios 数组第 1 个

编号 = 数组顺序,不要打乱。

实测注意:一旦挂了主体参考图,文字描述会被图片强烈压制。例如提示词写「蜘蛛侠大战黑寡妇」、参考图是一只猫, 实际生成的是「两只猫打架」。想精确控制画面,请把主体放图里、把动作放文字里。

7. 查询任务

GET /v1/videos/{task_id}
statusprogress含义
queued0排队中
in_progress50生成中
completed100成功,取 video_url
failed100失败,读 error.message

成功

{
  "id": "task_xxxxxxxxxxxxxxxx",
  "status": "completed",
  "progress": 100,
  "video_url": "https://media.example.com/.../xxx.mp4?X-Tos-Signature=...",
  "url": "https://media.example.com/.../xxx.mp4?X-Tos-Signature=..."
}

失败

{
  "id": "task_xxxxxxxxxxxxxxxx",
  "status": "failed",
  "progress": 100,
  "error": {
    "code": "upstream_failed",
    "message": "The generated audio may be related to copyright restrictions and was blocked by the provider policy."
  }
}
error.message 是上游原始原因,可直接展示给终端用户,不是笼统的「生成失败」。

8. 取视频

方式 A:直接下载链接(推荐)

用 video_url 直接下载。

curl -L -o out.mp4 "https://media.example.com/.../xxx.mp4?X-Tos-Signature=..."

方式 B:走网关代理

GET /v1/videos/{task_id}/content
Authorization: Bearer sk-xxxxxxxx

返回 video/mp4 字节流,由网关实时转发上游,服务器不存储文件。

链接 24 小时后过期,且不可续期。拿到链接必须立刻转存到自己的存储,否则过期只能重新生成(再次计费)。

9. 错误码

HTTP场景处理
400缺 resolution、时长越界、模型名错、素材不合规按 error.message 改参数,不扣费
401令牌无效或已禁用检查 sk- 令牌
402额度不足充值
429限流退避重试
200 + status=failed上游生成失败读 error.message,不要盲目重发

错误响应体:

{ "error": { "code": "", "message": "Invalid request: ...", "type": "new_api_error" } }

10. 计费

费用 = 实际输出秒数 × 分辨率单价
分辨率单价示例
480p$0.10 / 秒4 秒 = $0.40
720p$0.20 / 秒30 秒 = $6.00

11. 完整示例

Python

import time, requests

BASE, TOKEN = "https://independent.172-247-37-6.sslip.io", "sk-xxxxxxxx"
H = {"Authorization": f"Bearer {TOKEN}"}

# 1) 创建
r = requests.post(f"{BASE}/v1/videos", headers=H, json={
    "model": "seedance-2.5-wr-ref",
    "prompt": "@Image1 中的猫咪在屋顶飞檐走壁",
    "seconds": 4,
    "resolution": "480p",
    "ratio": "9:16",
    "reference_images": ["https://你的图/cat.png"],
}, timeout=120)
r.raise_for_status()
task_id = r.json()["id"]

# 2) 轮询
while True:
    s = requests.get(f"{BASE}/v1/videos/{task_id}", headers=H, timeout=30).json()
    if s["status"] == "completed":
        url = s["video_url"]
        break
    if s["status"] == "failed":
        raise RuntimeError(s["error"]["message"])
    time.sleep(10)

# 3) 立刻下载(24 小时内)
with requests.get(url, stream=True, timeout=300) as v:
    v.raise_for_status()
    with open(f"{task_id}.mp4", "wb") as f:
        for chunk in v.iter_content(1 << 20):
            f.write(chunk)
print("saved", f"{task_id}.mp4")

Node.js

const BASE = "https://independent.172-247-37-6.sslip.io";
const TOKEN = "sk-xxxxxxxx";
const H = { "Authorization": `Bearer ${TOKEN}`, "Content-Type": "application/json" };

const created = await fetch(`${BASE}/v1/videos`, {
  method: "POST", headers: H,
  body: JSON.stringify({
    model: "seedance-2.5-wr-ref",
    prompt: "一只橘猫在月夜屋顶上转身拔剑",
    seconds: 4, resolution: "480p", ratio: "9:16"
  })
}).then(r => r.json());

let url = null;
while (true) {
  const s = await fetch(`${BASE}/v1/videos/${created.id}`, { headers: H }).then(r => r.json());
  if (s.status === "completed") { url = s.video_url; break; }
  if (s.status === "failed") throw new Error(s.error.message);
  await new Promise(res => setTimeout(res, 10000));
}
console.log("done:", url);

cURL 轮询脚本

TASK=$(curl -s -X POST "$BASE/v1/videos" \
  -H "Authorization: Bearer $SK" -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.5-wr-ref","prompt":"...","seconds":4,"resolution":"480p"}' \
  | sed -n 's/.*"id":"\([^"]*\)".*/\1/p')

while :; do
  BODY=$(curl -s "$BASE/v1/videos/$TASK" -H "Authorization: Bearer $SK")
  echo "$BODY" | grep -q '"status":"completed"' && { echo "$BODY"; break; }
  echo "$BODY" | grep -q '"status":"failed"'    && { echo "$BODY"; exit 1; }
  sleep 10
done

12. 常见坑

坑现象解法
忘写 resolution400必填,三档之一
时长写 3 或 31400只能 4–30 或 -1
参考图用本地路径400必须公网 URL
同一单重复提交重复扣费超时先查状态,确认失败再重发
第二天才下载链接 40424 小时内转存

幂等建议

13. 更新日志

版本变更
v1.3新增 seedance-2.0-wr-ref(4–15 秒,参考图 9 / 视频 3 / 音频 3)
v1.2新增参考视频 / 参考音频;补充 @ 引用实测注意;明确 20480 字符上限
v1.1resolution 改为必填;1080p 暂不开放
v1.0首发:文生视频 + 参考图生视频

有疑问请联系管理员。文档版本 v1.3。