Wan 2.6 Flash 图生视频 API 怎么用？画幅跟图走

TL;DR

• Wan 2.6 Flash Image to Video（wan2.6-flash/image-to-video）上传 1 张图、写一句动作描述，生成 5、10 或 15 秒的 720p / 1080p 视频，可按需开同步音频；输出画幅跟随输入图，竖图直接出竖屏。打开模型页就能试，新用户注册送 200 积分。
• 价格按秒算、四个组合：720p 无声（默认）每秒 $0.029，开音频 $0.0575，1080p 无声 $0.043、开音频 $0.086（完整价格见价格页）。
• 调用走 HiAPI /v1/tasks 接口：image_urls 恰好 1 张图，成功后从 output 取视频地址（临时地址，及时保存）。

它能做什么

• 一张图 + 一句话 = 一段动作：画面主体和光线保持原图，模型只加你要的动态、镜头和氛围。
• 三种时长：5 / 10 / 15 秒，默认 5 秒。
• 画幅跟图走：没有画幅参数——横图出 16:9、竖图出竖屏、3:4 的图就出 3:4，社媒素材不用二次裁剪。
• 音频按需开：audio 默认关；开了以后声音跟画面同步生成（锅铲声、火焰声这类环境音）。

下面是真实成片（默认参数：720p、5 秒、无声）：

The fox turns its head toward the camera, its ears twitch, golden leaves drift down through the misty light

（中文意思：狐狸转头看向镜头，耳朵轻轻抖动，金色落叶在薄雾光线中飘落。上传狐狸照片作首帧；提示词也支持中文，最长 1500 字符。）

·

wan2.6-flash/image-to-video，720p，5 秒，16:9，1280×720，无声，$0.145。看完整成片 →

用这个提示词生成 →

价格：四个组合一张表

档位	每秒	5 秒	10 秒	15 秒
720p 无声（默认）	$0.029	$0.145	$0.29	$0.435
720P · 开音频	$0.0575	$0.2875	$0.575	$0.8625
1080P · 无声	$0.043	$0.215	$0.43	$0.645
1080P · 开音频	$0.086	$0.43	$0.86	$1.29

HiAPI 现价，2026 年 10 月 22 日核对。 以默认档为 1：开音频约 2 倍、升 1080p 约 1.5 倍、又升又开约 3 倍。失败不扣费。

两条上手路线

浏览器 3 步：打开模型页 → 上传图片、写动作描述 → 点生成，默认档 5 秒 $0.145，出片之后直接在页面里预览，满意了再写代码把接口接进自己的业务流程。

API 3 步：POST /v1/tasks 提交 → 拿 taskId → GET /v1/tasks/<taskId> 查到 success 后下载。

curl：第一条

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: your-unique-key-001" \
  -d '{
  "model": "wan2.6-flash/image-to-video",
  "input": {
    "prompt": "The fox turns its head toward the camera, its ears twitch, golden leaves drift down through the misty light",
    "image_urls": ["https://static.hiapi.ai/gallery/2026/10/ced2dd4214889094.jpg"],
    "duration": 5,
    "resolution": "720p",
    "audio": false
  }
}'

这条按现价是 720p 无声 × 5 秒 = $0.145。

Python：提交、轮询、下载

import time, uuid, requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "model": "wan2.6-flash/image-to-video",
    "input": {
        "prompt": "The fox turns its head toward the camera, its ears twitch, golden leaves drift down through the misty light",
        "image_urls": ["https://example.com/your-image.jpg"],
        "duration": 5,
        "resolution": "720p",
        "audio": False,
    },
}

resp = requests.post(
    BASE,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json=payload,
    timeout=30,
)
resp.raise_for_status()
task_id = resp.json()["taskId"]

while True:
    task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()
    print(task["status"])
    if task["status"] in ("success", "fail"):
        break
    time.sleep(5)

if task["status"] == "success":
    video = next(o for o in task["output"] if o.get("type") == "video")
    mp4 = requests.get(video["url"], timeout=120)   # 临时地址，尽快保存
    with open("output.mp4", "wb") as f:
        f.write(mp4.content)
    print("saved output.mp4")

参数表

字段	必填	取值	说明
image_urls	是	恰好 1 张	JPG / PNG / WebP，≥256×256，≤10MB；画幅决定输出画幅
prompt	是	1–1500 字符	描述动作、镜头和氛围；中英文都可以
duration	否	5 / 10 / 15，默认 5	只有这三档
resolution	否	720p / 1080p，默认 720p
audio	否	默认 false	同步音频，单独计价（见价格表）

请求体里出现表外字段会直接 400。

你会遇到的报错

状态码	含义	怎么处理
400 INVALID_REQUEST	请求体不合法（缺 image_urls 或 prompt、传了 2 张图、duration 传了 7）	对照参数表改请求体
402 INSUFFICIENT_QUOTA	余额不足（不扣费）	充值后重试
429 RATE_LIMITED	触发限流	降低提交频率
409 / 422 IDEMPOTENCY_KEY_*	同一幂等键重复提交	换新的 Idempotency-Key

任务终态失败还有 CONTENT_POLICY_VIOLATION、TASK_FAILED、TASK_TIMEOUT 等；失败不扣费。

上线前注意

• 回调：请求体顶层传 "callback": {"url": "https://..."}，终态自动通知。
• 及时转存：output 里的视频地址是临时的，拿到就下载。
• 图的质量是上限：至少 256×256、不超过 10MB；清晰大图出清晰视频。
• 竖版素材传竖图：没有画幅参数，想要 9:16 就上传竖图。

常见问题

画幅跟随输入图吗？

跟随。横图横屏、竖图竖屏，3:4 的图出 3:4——不用传任何比例参数。

音频要怎么开？

显式传 audio: true 才有声音，价格按 Sound On 档算（约 2 倍）。

时长可以传任意秒数吗？

不可以。只有 5 / 10 / 15 秒三档，传别的秒数会 400。

提示词能用中文吗？

能。中英文都可以，最长 1500 字符；写动作和镜头，不用重复描述画面。计费只看分辨率、时长和音频开关。

$10 能出多少条？

默认档（720p 无声 5 秒）一条 $0.145，$10 约 68 条。

下一步：拿一张你的产品图或照片去模型页动起来，四个场景模板看提示词大全。