视频续写
Seedance 2.5 的 video_extension:接着一段已有的视频往后续写,或者往前补一段。
Seedance 2.5 接着一段已有的视频生成新的画面:往后续写(forward),或者往前补一段(backward)。结果只有新生成的那一段,不包含你传的视频,需要完整视频时请自己拼接。
创建任务
https://api.nanoapi.ai/v1/tasks用所有模型共用的创建任务接口,model 传 "seedance-2.5"。接口通常不到 1 秒返回,几秒内冻结费用,一般几分钟出片;任务结束后获取结果。
请求头
| 请求头 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <API Key>,见鉴权 |
Content-Type | 是 | application/json |
Idempotency-Key | 否 | 每个新任务一个唯一字符串,建议用 UUID(1–255 个字符),见防止重复创建 |
请求体
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | seedance-2.5 |
mode | string | 是 | video_extension |
video_url | string | 是 | 要续写的视频,不超过 30 秒,见素材。http(s) 链接,最长 4096 字符,必须能直接下载,不能指向内网地址 |
extension_mode | string | 是 | forward:接着视频结尾往后续写;backward:在视频开头之前补一段 |
prompt | string | 是 | 描述新的画面,最长 8000 字符 |
resolution | string | 是 | 480p、720p 或 1080p,决定价格 |
duration | integer | 是 | 续写出来那一段的长度(秒),4–30,按它计费,见价格 |
generate_audio | boolean | 否 | 新的那一段是否带声音,默认 true。带不带都是同一个价 |
webhook_url | string | 否 | 任务成功或失败时通知该地址:https,最长 2048 字符,不能指向内网、回环或保留地址。见回调 |
不能传 aspect_ratio(新的那一段跟随要续写的视频),也不能传 image_urls、video_urls、audio_urls,传了返回 400 invalid_request,param 是对应的参数名(例如 aspect_ratio is not allowed for mode video_extension; the output follows the source video)。
往后续写 5 秒,720p:
curl https://api.nanoapi.ai/v1/tasks \
-H "Authorization: Bearer $NANOAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5",
"mode": "video_extension",
"video_url": "https://example.com/source.mp4",
"extension_mode": "forward",
"prompt": "Continue the scene smoothly",
"resolution": "720p",
"duration": 5
}'响应:200 OK。data 是刚创建的任务,只有下面这几个字段,各字段的含义见创建任务的返回。保存 data.id,用它获取结果:任务成功后,查询结果或回调里的 data.outputs[0].url 就是新生成的那一段。创建之后任务仍可能失败(例如视频下载不了),以查询或回调的结果为准。
{
"code": 200,
"message": "success",
"data": {
"object": "task",
"id": "tk_01jbd2s8x4c6v9b3n5m7q1w4e8",
"model": "seedance-2.5",
"status": "queued",
"error": null,
"created_at": "2026-10-31T08:30:00Z"
}
}价格
费用 = 续写的时长 duration × 所选分辨率的每秒单价正在读取当前价格…
例如上面的请求(720p、5 秒)是 5 × 720p 的每秒单价。
计费秒数就是新的那一段的 duration,和要续写的视频有多长无关。价格会调整,当前单价请从 GET /v1/products 读取(prices 里 mode 是这个模式的行),不要写死;实际费用以查询任务返回的 billing.frozen 为准。Seedance 2.5 所有模式的价格见 Seedance 2.5 → 价格。
错误
创建请求出错:请求返回 HTTP 错误,任务不会创建。这个模式特有的:
| 状态码 | error.type | 何时出现 | 怎么处理 |
|---|---|---|---|
400 | invalid_request | 没传 video_url 或 prompt,extension_mode 没传或者不是 forward / backward(extension_mode should be 'forward' or 'backward' for mode video_extension),传了 aspect_ratio、image_urls、video_urls 或 audio_urls,或者 resolution、duration 取值不对。param 是对应的参数名 | 按 param 改好参数后重新请求 |
创建接口的其他错误(401、402、429 等)见创建任务 → 错误。
任务失败:创建请求成功(200),任务之后变成 failed。这种情况没有 HTTP 状态码,原因在任务的 error.type,通过查询任务或回调拿到。
error.type | 何时出现 | 怎么处理 |
|---|---|---|
invalid_media | 视频下载不了或读不了(损坏、格式不支持)。提交后几秒内下载视频时才发现,冻结的费用全额退回 | 换成能公开下载的视频链接,重新创建 |
video_too_long | 视频超过 30 秒(The video duration must be at most 30 seconds.)。提交后几秒内下载视频时才发现(started_at 可能为 null),冻结的费用全额退回 | 把视频裁剪到 30 秒以内(forward 保留结尾,backward 保留开头),重新创建 |
所有模式共用的失败原因(例如余额不够这个任务)见 Seedance 2.5 → 错误,全部失败原因见失败原因。