参考生成

Seedance 2.5 让参考图里的人物、物体出现在新视频里，照着参考视频里的动作、运镜，或者配上参考音频。三样至少传一样，只传参考音频也可以。

创建任务

用所有模型共用的创建任务接口，model 传 "seedance-2.5"。接口通常不到 1 秒返回，几秒内冻结费用，一般几分钟出片；任务结束后获取结果。

请求头

请求体

image_urls、video_urls、audio_urls 至少传一样，都没传返回 400 invalid_request，param 为 image_urls。不能传 video_url，传了返回 400 invalid_request，param 为 video_url。

一张参考图、一段参考视频加背景音乐，竖屏，720p、5 秒：

curl https://api.nanoapi.ai/v1/tasks \
  -H "Authorization: Bearer $NANOAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "mode": "reference_to_video",
    "image_urls": ["https://example.com/cat.jpg"],
    "video_urls": ["https://example.com/walk.mp4"],
    "audio_urls": ["https://example.com/music.mp3"],
    "prompt": "The cat from @Image1 walks down the street like the woman in @Video1, with @Audio1 as background music",
    "aspect_ratio": "9:16",
    "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 错误，任务不会创建。这个模式特有的：

创建接口的其他错误（401、402、429 等）见创建任务 → 错误。

任务失败：创建请求成功（200），任务之后变成 failed。这种情况没有 HTTP 状态码，原因在任务的 error.type，通过查询任务或回调拿到。

所有模式共用的失败原因（例如余额不够这个任务）见 Seedance 2.5 → 错误，全部失败原因见失败原因。