首尾帧生视频
Wan 3.0 的 image_to_video:从首帧开始生成带声音的视频,也可以再加一张尾帧。
Wan 3.0 从 image_urls 的第 1 张图开始生成,传了第 2 张时以它结尾,prompt 描述中间发生什么。比例跟随首帧,因此不能传 aspect_ratio。两张图的方向请保持一致(都是横图或都是竖图),方向不一致(一张横图一张竖图)时可能生成失败。
创建任务
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 | 是 | image_to_video |
image_urls | string[] | 是 | 1–2 张:第 1 张是首帧,第 2 张(可选)是尾帧。见素材 |
prompt | string | 是 | 描述视频里发生什么,最长 8000 字符,建议用英文 |
resolution | string | 是 | 480p、720p 或 1080p,决定价格 |
duration | integer | 是 | 输出时长(秒),2–30,按此计费,见价格 |
generate_audio | boolean | 否 | 输出视频是否带声音,默认 true。不影响价格 |
enable_thinking | boolean | 否 | true 时生成前先让模型推理提示词,更贴合描述,但更慢。默认 false |
webhook_url | string | 否 | 任务成功或失败时通知该地址:https,最长 2048 字符,不能指向内网、回环或保留地址。见回调 |
prime、首尾帧、1080p、5 秒:
curl https://api.nanoapi.ai/v1/tasks \
-H "Authorization: Bearer $NANOAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan-3.0",
"variant": "prime",
"mode": "image_to_video",
"image_urls": [
"https://example.com/first_frame.jpg",
"https://example.com/last_frame.jpg"
],
"prompt": "The woman turns around and walks toward the window, the camera follows her",
"resolution": "1080p",
"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 → 错误。本模式的参数规则见上面的参数表。