POST
https://nezhagate.com/v1/videos/generations
Seedance 2.0 · Clip 视频生成（异步任务，特价按条计费）：时长 duration 只能取 5 / 10 / 15 秒（默认 15；竖屏 9:16 固定 15 秒），720P，画幅 size=16:9 / 9:16；可带最多 9 张参考图（images，定人物、场景和风格，在提示词里用 @Image1 点名），支持真人人脸参考图；不收参考视频和参考音频。提交后返回任务号（HTTP 202），轮询 GET /v1/videos/jobs/{id} 直到 status=succeeded，结果在 data[0].url。每条 $1.00，三种时长同价；失败全额退。
在 Playground 试用 →认证
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
在控制台创建 API Key 后即可调用。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型 ID，此处为 seedance-2.0-clip。 |
| prompt | string | 是 | 视频内容、镜头与运动的描述。最长 5000 字节（UTF-8，中文一个字算 3 字节）。 |
| duration | integer | 否 | 时长只能取 5 / 10 / 15 秒（不传默认 15 秒，即最长的那档）；竖屏 9:16 目前只支持 15 秒；传其他值会被拒绝。也可写作 seconds。特价按条计费，三种时长同价。 |
| resolution | string | 否 | 分辨率固定 720P（不传也是 720P）；每条 $1.00，5 / 10 / 15 秒同价。 |
| size | string | 否 | 画幅：16:9（横屏，默认，5 / 10 / 15 秒）或 9:16（竖屏，固定 15 秒）。也可写作 aspect_ratio。 |
| image | string | 否 | 图生视频：带参考图即走图生视频，可传公网 URL、data: URI 或 base64；不带则为文生视频。 |
| images | array | 否 | 多张参考图，最多 9 张。超过上限直接报错，不会截断。也可写作 reference_images。 |
请求示例
# 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.0-clip", "prompt": "a paper crane unfolding over a misty lake", "duration": 15, "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'响应示例
{
"id": "img_3f9a...c2",
"object": "video.generation.job",
"status": "queued",
"model": "seedance-2.0-clip"
}异步视频任务（提交 → 轮询）
提交后立即返回 HTTP 202 与任务号，轮询直到 status=succeeded，结果在 data[0].url（mp4 直链）。时长、清晰度与画面比例的可选值见上方参数表；带 image 参数即图生视频。
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "seedance-2.0-clip", "prompt": "一只猫在日落时冲浪", "size": "16:9"}'参考图：额外传 images（最多 9 张，可为公网 URL、data: URI 或 base64），在提示词里用 @Image1 点名；参考图定人物、场景和风格，不作首帧。这一档不收参考视频和参考音频。
支持真人人脸参考图，无需遮挡。请确保你有权使用图中人物的肖像。
{ "id": "img_3f9a...c2", "object": "video.generation.job", "status": "queued", "model": "seedance-2.0-clip" }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.0-clip",
"data": [{ "url": "https://img.nezhagate.com/i/9f86d081a8....mp4" }]
}🕑 data[0].url 是本站图床链接，保留 60 天后自动删除；需要长期使用，请下载后存到你自己的存储或 CDN。
按条计费、失败全额退；生成失败或超时会自动退还预扣积分。
错误码
错误体统一为 error.message / error.type / error.code / error.param；请按 code 分支，完整清单见接入指南。
| HTTP | code | 说明 |
|---|---|---|
| 401 | invalid_api_key | API Key 缺失或无效 |
| 402 | insufficient_quota | 余额不足或 Key 超出限额 |
| 400 | invalid_request | 模型或参数不支持 |
| 429 | rate_limit_exceeded | 上游限流 |
| 502 | upstream_error | 所有上游线路失败 |
