チュートリアル
Wan 2.6 Flash 画像から動画生成 API の使い方:アスペクト比は画像に追従
1枚の画像と1文で5/10/15秒の動画に:4つの価格組み合わせ、curl/Python サンプルとパラメータ表。
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つのシーンテンプレートはプロンプト集をご覧ください。
関連記事
すべての記事を見る →-
チュートリアル
HiAPI API で hailuo-2.3-fast/image-to-video を呼び出す方法:curl と Python の実践
高速・低コストな画像から動画へのティアにおける最初の実行可能なリクエスト — モデル ID から MP4 のダウンロードまで
-
チュートリアル
HiAPI APIでhailuo-2.3/text-to-videoを呼び出す方法:curl、Python、実行可能なリクエスト例
-
チュートリアル
HiAPI で Kandinsky 6.0 Pro のテキストto動画を使用する:curl と Python チュートリアル
リクエスト優先の実践デモ:プロンプトから動画クリップへの呼び出しを構築し、リクエストを送信し、完了状態をポーリングし、結果をダウンロードする