Seedance 2.5 API:价格、参数与调用代码
Seedance 2.5 是字节跳动的视频模型:一次生成最长 30 秒、自带原生音轨,可以只用文字,也可以带最多 30 张参考图、10 个参考视频和 10 段参考音频。在 NezhaGate 上它是一个 OpenAI 风格的异步接口:480P 每秒 $0.10,720P 每秒 $0.158,失败的任务不扣费。
更新于 2026-10-03
Seedance 2.5 一览
Seedance 2.5 是字节跳动 2026 年 7 月 31 日发布的视频模型(字节 Seed 官方介绍)。最大的变化是时长:一镜到底最长 30 秒、自带原生音轨,Seedance 2.0 最长只有 15 秒。在 NezhaGate 上它和其他模型共用同一个 API Key。
| 模型 ID | seedance-2.5 |
|---|---|
| 接口 | POST https://nezhagate.com/v1/videos/generations,再 GET /v1/videos/jobs/{id} 查结果 |
| 时长 | 4 到 30 秒之间任意整数秒(duration) |
| 分辨率 | 480P、720P(默认);1080P 即将上线 |
| 画幅 | 16:9(默认)、9:16、1:1、4:3、3:4(size) |
| 参考素材 | 同一个请求最多 30 张图、10 个视频(合计 30 秒内)、10 段音频 |
| 音轨 | 默认生成原生音轨,audio: false 可关闭 |
| 提示词 | 最多 11,000 字,中英文按同样字数算 |
| 结果 | data[0].url 里的 mp4 链接,由我们托管,保留 60 天 |
价格
按生成的秒数计费,参考图、参考视频和参考音频都不计费。任务失败或超时全额退回。
| 分辨率 | 每秒 | 5 秒 | 10 秒 | 15 秒 | 30 秒 |
|---|---|---|---|---|---|
| 480P | $0.10 | $0.50 | $1.00 | $1.50 | $3.00 |
| 720P | $0.158 | $0.79 | $1.58 | $2.37 | $4.74 |
字节官方 BytePlus 的价格按 16:9 折算,480p 每秒 $0.103,720p 每秒 $0.231;720P 比官方省 31%。固定 30 秒的 seedance-2.5-30s 每条 720P $1.50。各家价格并排见 Seedance API 价格对比。
提交任务、拿到视频
视频是异步任务:提交后立刻返回 HTTP 202 和任务号,之后轮询,直到 status 变成 succeeded,再读 data[0].url。先在控制台创建 Key,设成环境变量 API_KEY。
curl
# 1) 提交:返回 {"id": "img_...", "status": "queued"}
curl https://nezhagate.com/v1/videos/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5",
"prompt": "黄昏,守塔人沿着旋转楼梯爬上灯塔,灯亮起,光束扫过翻涌的海面。镜头缓慢推近,暖色光,胶片颗粒。",
"duration": 10,
"resolution": "720P",
"size": "16:9"
}'
# 2) 每 15 秒查一次,status 变成 succeeded 后读 data[0].url
curl https://nezhagate.com/v1/videos/jobs/JOB_ID -H "Authorization: Bearer $API_KEY"Python
import os
import time
import requests
BASE = "https://nezhagate.com/v1"
HEADERS = {"Authorization": "Bearer " + os.environ["API_KEY"]}
job = requests.post(f"{BASE}/videos/generations", headers=HEADERS, json={
"model": "seedance-2.5",
"prompt": "黄昏,守塔人沿着旋转楼梯爬上灯塔,灯亮起,光束扫过翻涌的海面。镜头缓慢推近,暖色光,胶片颗粒。",
"duration": 10,
"resolution": "720P",
"size": "16:9",
}).json()
print("任务号", job["id"])
while True:
time.sleep(15)
r = requests.get(f"{BASE}/videos/jobs/{job['id']}", headers=HEADERS).json()
if r["status"] == "succeeded":
print(r["data"][0]["url"])
break
if r["status"] == "failed":
raise SystemExit(r["error"]["message"]) # 失败全额退回Node.js
const BASE = "https://nezhagate.com/v1";
const headers = { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" };
const job = await (await fetch(`${BASE}/videos/generations`, {
method: "POST",
headers,
body: JSON.stringify({
model: "seedance-2.5",
prompt: "黄昏,守塔人沿着旋转楼梯爬上灯塔,灯亮起,光束扫过翻涌的海面。",
duration: 10,
resolution: "720P",
size: "16:9",
}),
})).json();
while (true) {
await new Promise((ok) => setTimeout(ok, 15000));
const r = await (await fetch(`${BASE}/videos/jobs/${job.id}`, { headers })).json();
if (r.status === "succeeded") { console.log(r.data[0].url); break; }
if (r.status === "failed") throw new Error(r.error.message);
}参考图、参考视频和参考音频
参考素材放在同一个请求里,在提示词里按顺序指代:images 里的图是 @Image1、@Image2,video_references 里的视频是 @Video1,audio_reference 里的音频是 @Audio1。每一项可以是公网链接,也可以是 base64 data URI(由我们托管 7 天)。
{
"model": "seedance-2.5",
"prompt": "@Image1 的舞者在 @Image2 的天台上跳出 @Video1 的动作,剪辑卡 @Audio1 的节拍。",
"images": ["https://example.com/dancer.png", "https://example.com/rooftop.png"],
"video_references": ["https://example.com/moves.mp4"],
"audio_reference": ["https://example.com/beat.mp3"],
"duration": 12,
"resolution": "720P",
"size": "9:16"
}Seedance 没有首帧模式:每张图都是人物、物体、场景或风格的参考,参考图不一定是视频的第一帧。在提示词里逐个点名参考素材,并写清要保留它的什么。
会导致请求失败的限制
- 图超过 30 张、视频超过 10 个、音频超过 10 段,或参考视频合计超过 30 秒:提交时直接拒绝,不会悄悄截断。
- 提示词超过 11,000 字。
- 时长不在 4 到 30 秒之间,或画幅不是上面五种(不支持 21:9)。
- 内容审核不通过。真人照片可能被拒;你自己生成的人物形象,包括写实风格,都可以作参考图。
以上每一种都会返回写明原因的报错;提交后才失败的任务全额退回。
出片要多久
只统计真实客户的请求;不计入我们自己的测试、因客户端参数错误被拒(4xx)的请求,以及模型拒绝生成的内容。失败的调用不扣费。每 10 分钟更新一次。
时长越长、分辨率越高,出片越慢,高峰期也会慢一些。保存任务号轮询即可,不要重复提交:每次提交都是一个新的付费任务。没能在时限内渲染完的任务会以 failed 结束,error 里写明原因,并全额退回。
常见问题
Seedance 2.5 API 多少钱?
Seedance 2.5 一条视频最长多少秒?
Seedance 2.5 支持图生视频吗?
可以用参考视频和参考音频吗?
Seedance 2.5 出片要多久?
有 1080P 吗?
同一个 OpenAI 兼容的 Key 也能调用 NezhaGate 上其他对话、图片和视频模型。按量计费,失败的任务全额退款。
获取 API Key 在线试用 各家价格对比