参考生成
Wan 3.0 的 reference_to_video:用参考图、参考视频、参考音频生成带声音的新视频。
Wan 3.0 让参考图里的人物、物体出现在新视频里,参照参考视频里的动作、运镜,或者用参考音频作为声音。image_urls、video_urls、audio_urls 三者至少传一项,只传参考音频也可以。
参考图(image_urls) | 参考视频(video_urls) | 参考音频(audio_urls) | |
|---|---|---|---|
| 数量 | 最多 10 张 | 最多 5 段 | 最多 5 段 |
| 时长 | – | 每段 1–15 秒;总时长不超过 15 秒(duration 超过 15 秒时不超过 30 − duration) | 每段及总时长均不超过 15 秒 |
带参考视频时,duration 最多为 30 − 视频段数。其他要求见素材。
创建任务
POST
https://api.nanoapi.ai/v1/tasks用所有模型共用的创建任务接口,model 传 "wan-3.0"。
请求头
| 请求头 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <API Key>,见鉴权 |
Content-Type | 是 | application/json |
Idempotency-Key | 否 | 每个新任务一个唯一字符串,建议用 UUID(1–255 个字符),见防止重复创建 |
请求体
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | wan-3.0 |
variant | string | 是 | standard 或 prime,见版本,决定价格 |
mode | string | 是 | reference_to_video |
image_urls | string[] | 条件必填 | 与 video_urls、audio_urls 至少传一项。最多 10 张参考图 |
video_urls | string[] | 条件必填 | 与 image_urls、audio_urls 至少传一项。最多 5 段参考视频:每段 1–15 秒,总时长不超过 15 秒,且总时长加上 duration 不超过 30 秒。见素材 |
audio_urls | string[] | 条件必填 | 与 image_urls、video_urls 至少传一项。最多 5 段参考音频(MP3 或 WAV):每段及总时长均不超过 15 秒 |
prompt | string | 是 | 描述要生成的画面,最长 8000 字符,建议用英文。可以用 <<<image_1>>>、<<<video_1>>>、<<<audio_1>>> 指代素材,见引用素材 |
resolution | string | 是 | 480p、720p 或 1080p,决定价格 |
aspect_ratio | string | 是 | 16:9、9:16、1:1、4:3、3:4 或 auto,auto 跟随参考图、参考视频的比例(只有参考音频时按 16:9) |
duration | integer | 是 | 输出时长(秒),2–30,按此计费,见价格。带参考视频时最多为 30 − 视频段数 |
generate_audio | boolean | 否 | 输出视频是否带声音,默认 true。不影响价格 |
enable_thinking | boolean | 否 | true 时生成前先让模型推理提示词,更贴合描述,但更慢。默认 false |
webhook_url | string | 否 | 任务成功或失败时通知该地址:https,最长 2048 字符,不能指向内网、回环或保留地址。见回调 |
一张参考图、一段参考视频加背景音乐,480p、5 秒,比例 auto(跟随参考图和参考视频):
curl https://api.nanoapi.ai/v1/tasks \
-H "Authorization: Bearer $NANOAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan-3.0",
"variant": "standard",
"mode": "reference_to_video",
"image_urls": ["https://example.com/cat.jpg"],
"video_urls": ["https://example.com/camera_move.mp4"],
"audio_urls": ["https://example.com/music.mp3"],
"prompt": "The cat from <<<image_1>>> sits on the car hood, the camera moves like in <<<video_1>>>, with <<<audio_1>>> as the background sound",
"resolution": "480p",
"aspect_ratio": "auto",
"duration": 5
}'响应:200 OK,返回新建的任务(字段说明)。保存 data.id,用它获取结果;任务创建后仍可能失败,见错误。
{
"code": 200,
"message": "success",
"data": {
"object": "task",
"id": "tk_01jbq5w8m2c4x7b0n3q6t9e1r5",
"model": "wan-3.0",
"status": "queued",
"error": null,
"created_at": "2026-11-11T08:30:00Z"
}
}价格
费用 = 输出时长 duration × 所选版本和分辨率的每秒单价正在读取当前价格…
计费秒数即请求的 duration:参考图、参考视频、参考音频、输出视频是否带声音(generate_audio)、enable_thinking 都不影响价格。当前单价见 GET /v1/products(prices 里这个 variant 的行),以任务的 billing.frozen 为准;冻结和扣费规则见计费。所有版本的价格见 Wan 3.0 → 价格。
错误
见 Wan 3.0 → 错误。本模式的参数规则见上面的参数表。