HiAPI
ブログ

チュートリアル

Wan 2.6 Flash 画像から動画生成 API の使い方:アスペクト比は画像に追従

1枚の画像と1文で5/10/15秒の動画に:4つの価格組み合わせ、curl/Python サンプルとパラメータ表。

Oct 22, 2026
Wan 2.6 Flash 画像から動画生成 API の使い方:アスペクト比は画像に追従

TL;DR

  • Wan 2.6 Flash Image to Video(wan2.6-flash/image-to-video)は画像を1枚アップロードし、動作の説明を1文書くだけで、5秒・10秒・15秒の 720p / 1080p 動画を生成でき、必要に応じて同期オーディオも有効にできます。出力のアスペクト比は入力画像に追従し、縦画像からはそのまま縦向き動画が出力されます。モデルページを開くだけで試せて、新規ユーザー登録で 200 クレジットが付与されます。
  • 価格は秒単位で、4つの組み合わせがあります:720p 音声なし(デフォルト)は毎秒 $0.029、音声有効で $0.0575、1080p 音声なしで $0.043、音声有効で $0.086(完全な価格は価格ページをご覧ください)。
  • 呼び出しは HiAPI の /v1/tasks エンドポイントを使用します:image_urls はちょうど1枚の画像で、成功後は output から動画の URL を取得します(一時 URL なので早めに保存してください)。

できること

  • 画像1枚 + 1文 = 1つの動作:画面の主体や光は元画像のまま、モデルは指定した動き・カメラワーク・雰囲気だけを加えます。
  • 3種類の長さ:5 / 10 / 15 秒、デフォルトは 5 秒。
  • アスペクト比は画像に追従:アスペクト比パラメータはありません。横画像なら 16:9、縦画像なら縦向き、3:4 の画像なら 3:4 で出力されるため、SNS 素材を再トリミングする必要がありません。
  • 音声は必要に応じて有効化: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。完成動画を見る →

このプロンプトで生成する →

価格:4つの組み合わせを一表に

プラン 毎秒 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 倍。失敗時は課金されません。

2つの導入ルート

ブラウザで3ステップ:モデルページを開く → 画像をアップロードし動作を記述 → 生成をクリック。デフォルトプランは5秒で $0.145。生成後はページ上でそのままプレビューでき、納得してからコードを書いて API を自社の業務フローに組み込めます。

API で3ステップ:POST /v1/tasks で送信 → taskId を取得 → GET /v1/tasks/<taskId> で success を確認してダウンロード。

curl:最初の1本

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)   # 一時 URL なのでできるだけ早く保存
    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 この3段階のみ
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 内の動画 URL は一時的なので、取得したらすぐにダウンロードしてください。
  • 画像の品質が上限を決める:最低 256×256、10MB 以下。鮮明で大きな画像ほど鮮明な動画になります。
  • 縦向き素材は縦画像をアップロード:アスペクト比パラメータはないので、9:16 が欲しければ縦画像をアップロードしてください。

よくある質問

アスペクト比は入力画像に追従しますか?

追従します。横画像は横画面、縦画像は縦画面、3:4 の画像は 3:4 で出力されます。比率パラメータを渡す必要はありません。

音声はどうやって有効にしますか?

明示的に audio: true を渡すと音声が出ます。価格は Sound On プランで計算されます(約2倍)。

長さは任意の秒数を渡せますか?

いいえ。5 / 10 / 15 秒の3段階のみで、それ以外の秒数を渡すと 400 になります。

プロンプトは中国語でも使えますか?

使えます。中国語・英語どちらも可能で、最大1500文字です。動作とカメラワークを書き、画面の説明を繰り返す必要はありません。課金は解像度、長さ、音声のオン/オフのみで決まります。

$10 で何本生成できますか?

デフォルトプラン(720p 音声なし 5秒)は1本 $0.145 なので、$10 で約68本です。

次のステップ:お手持ちの製品画像や写真をモデルページで動かしてみてください。4つのシーンテンプレートはプロンプト集をご覧ください。

永続的なAIアーティファクトで開発を始める

APIキーを取得して、タスクベースの1つのAPIで画像・動画・音声モデルを呼び出せます。

APIドキュメントを読む