NezhaGateNezhaGate
seedance-2.5-30s

Seedance 2.5 · 30s · API

POST https://nezhagate.com/v1/videos/generations

Seedance 2.5 · 30s 视频生成(异步任务):时长 duration 只能取 30 秒(720P 只支持 30 秒),分辨率 720P,画幅 size=16:9 / 9:16 / 1:1 / 4:3 / 3:4;带 image 即图生视频(最多 9 张)。提交后返回任务号(HTTP 202),轮询 GET /v1/videos/jobs/{id} 直到 status=succeeded,结果在 data[0].url。按条计费:$1.50(不传 resolution 默认 720P),同一档内最短与最长同价;失败全额退。

在 Playground 试用 →

认证

Header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

在控制台创建 API Key 后即可调用。

请求参数

参数类型必填说明
model string 是 模型 ID,此处为 seedance-2.5-30s。
prompt string 是 视频内容、镜头与运动的描述。最长 5000 字节(UTF-8,中文一个字算 3 字节)。
duration integer 否 时长只能取 30 秒(默认 30)。也可写作 seconds。720P 只支持 30 秒。本模型按条计费,时长不影响价格。
resolution string 否 分辨率:$1.50(不传默认 720P)。价格只随分辨率变,不随时长变。
size string 否 画幅:16:9 / 9:16 / 1:1 / 4:3 / 3:4(默认 16:9)。也可写作 aspect_ratio。本模型不支持 21:9。
image string 否 图生视频:带参考图即走图生视频,可传公网 URL、data: URI 或 base64;不带则为文生视频。
images array 否 多张参考图,最多 9 张。超过上限直接报错,不会截断。也可写作 reference_images。

请求示例

cURL
# 1) submit -> 202 {"id":"img_...","status":"queued"}
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "seedance-2.5-30s", "prompt": "a paper crane unfolding over a misty lake", "duration": 30, "resolution": "720P", "size": "16:9"}'
# image-to-video: also pass  "image": "https://example.com/ref.png"
# 2) poll every ~5s until status=succeeded, then read data[0].url
curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'

响应示例

200 · JSON
{
  "id": "img_3f9a...c2",
  "object": "video.generation.job",
  "status": "queued",
  "model": "seedance-2.5-30s"
}

异步视频任务(提交 → 轮询)

提交后立即返回 HTTP 202 与任务号,轮询直到 status=succeeded,结果在 data[0].url(mp4 直链)。时长、清晰度与画面比例的可选值见上方参数表;带 image 参数即图生视频。

curl · 提交任务(文生视频)
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "seedance-2.5-30s", "prompt": "一只猫在日落时冲浪", "size": "16:9"}'
图生视频:额外传 image 参数(首帧参考图,可为公网 URL、data: URI 或 base64)。
支持真人人脸参考图,无需遮挡。请确保你有权使用图中人物的肖像。
响应示例
{ "id": "img_3f9a...c2", "object": "video.generation.job", "status": "queued", "model": "seedance-2.5-30s" }
curl · 轮询结果
curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'
响应示例
{
  "id": "img_3f9a...c2",
  "object": "video.generation.job",
  "status": "succeeded",
  "model": "seedance-2.5-30s",
  "data": [{ "url": "https://img.nezhagate.com/i/9f86d081a8....mp4" }]
}

🕑 data[0].url 是本站图床链接,保留 60 天后自动删除;需要长期使用,请下载后存到你自己的存储或 CDN。

按条计费、失败全额退;生成失败或超时会自动退还预扣积分。

错误码

错误体统一为 error.message / error.type / error.code / error.param;请按 code 分支,完整清单见接入指南。

HTTPcode说明
401invalid_api_keyAPI Key 缺失或无效
402insufficient_quota余额不足或 Key 超出限额
400invalid_request模型或参数不支持
429rate_limit_exceeded上游限流
502upstream_error所有上游线路失败