Wan 3.0 Prime API 中国語チュートリアル：テキスト生成、開始・終了フレーム、参照生成動画

TL;DR

• Wan 3.0 Prime（万相 3.0 加速版）は Alibaba Wan 3.0 の高速回線で、モデル名は wan3.0-video-prime。1つのモデルでテキスト生成動画、開始・終了フレーム生成動画、参照生成動画ができ、参照素材には画像、音声、さらにはドキュメントや Web ページも使えます。1本 2〜30 秒で、デフォルトで音声付き。モデルページを開く とオンラインで生成できます。
• 秒単位の課金：480P は毎秒 $0.0875、720P は $0.18、1080P は $0.36。5 秒の 480P ならわずか $0.4375。
• 2つの落とし穴：解像度は大文字で 480P / 720P / 1080P と書く必要があり、しかもデフォルトは 1080P。Prime は参照動画を受け付けません。

まずは結果を見る

テキスト生成動画、480P、5 秒、音声付き（音声をオンにすると雨音、車の流れ、グリルのジュージューという音が聞こえます）：

Rain streaking down a narrow neon-lit alley at night; a slow dolly-forward past
steaming street-food stalls, magenta and cyan reflections rippling in the wet
pavement, a tabby cat darting between crates mid-shot. Ambient sound: steady
rain, distant traffic hiss, the sizzle of a grill and a low synth drone.

このプロンプトで生成 →（5 秒、480P、16:9、音声オン）

wan3.0-video-prime、480P、5 秒、音声付き、$0.4375。

参照生成動画：陶器のキツネの置物の画像を渡して動かし、外観は変えないようにします。

Bring the referenced ceramic fox figurine to life: it slowly turns its head
toward camera, blinks, and tilts with a curious expression; subtle idle
breathing, a light breeze stirring the tiny scarf, soft studio key light on a
clean seamless backdrop, smooth loopable motion.

このプロンプトで生成 →（参照画像をアップロード、5 秒、480P、9:16）

wan3.0-video-prime、参照画像、480P、5 秒、9:16、$0.4375。

curl：最初の1本

5 秒 480P、$0.4375：

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {
      "prompt": "茶トラ猫が日差しの降り注ぐ窓辺で大きくあくびをし、しっぽをゆっくり振る。カメラはゆっくり寄っていき、暖色系のトーン",
      "resolution": "480P",
      "duration": 5,
      "aspect_ratio": "16:9",
      "audio": false
    }
  }'

data.taskId が返ってきたら、GET /v1/tasks/{taskId} で status が success になるのを確認し、output[0].url をダウンロードします。

Python：送信、ポーリング、ダウンロード

# pip install requests；先に export HIAPI_KEY=あなたの Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(timeout_s=900, **inp):
    # 同じタスクを再送信するときは同じ Idempotency-Key を付けて、二重課金を避ける
    r = requests.post(API, json={"model": "wan3.0-video-prime", "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 参照生成動画：参照画像の製品を動かす、480P 5 秒（$0.4375）
url = generate(
    prompt="参照画像の香水瓶を黒い大理石の上でゆっくり回転させ、サイドからの逆光がボトルをなぞり、カメラはゆっくり寄っていく",
    reference_image_urls=["https://your-cdn.example.com/perfume.jpg"],
    resolution="480P", duration=5, aspect_ratio="9:16", audio=False,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

3つの使い方

使い方	渡すもの	説明
テキスト生成動画	prompt のみ
開始・終了フレーム	first_frame_url、必要なら last_frame_url も追加	参照素材とは同時に使えません
参照生成動画	reference_image_urls（最大 10 枚）、reference_audio_urls（最大 5 本、画像と一緒に使う）、reference_file_urls または reference_link_urls（それぞれ最大 1 つ、どちらか一方）	プロンプト内では順番に Image1、Audio1 で素材を指します

参照ドキュメントと Web ページは Wan 3.0 の特徴です：ブランドガイドラインの PDF や商品ページのリンクをモデルに渡し、その中の情報に沿って動画を生成させられます。Web ページはログインなしで開ける必要があります。

パラメータ一覧

パラメータ	値	説明
prompt	文字列、必須	シーン、動作、カメラ、光、音を書く
resolution	480P / 720P / 1080P、デフォルト 1080P	大文字、価格を直接左右する
duration	2〜30 の整数、デフォルト 5	単位は秒
aspect_ratio	adaptive 16:9 4:3 1:1 3:4 9:16、デフォルト adaptive	adaptive は素材とプロンプトに応じて自動選択
audio	デフォルト true	音声トラックを同時生成、追加料金なし
seed	0〜2147483647	シードを固定すると再現しやすい
first_frame_url / last_frame_url	画像 URL	開始・終了フレーム
reference_image_urls など	上の表を参照	参照生成動画

費用を計算する

長さ	480P（$0.0875/秒）	720P（$0.18/秒）	1080P（$0.36/秒）
5 秒	$0.4375	$0.90	$1.80
10 秒	$0.875	$1.80	$3.60
30 秒	$2.625	$5.40	$10.80

まずは 480P でプロンプトを調整し、確定してから 720P や 1080P に上げましょう。急がないなら、Wan 3.0 標準版（wan3.0-video）の 720P は毎秒わずか $0.08 で、参照動画も渡せます。完全な価格は Wan 3.0 Prime API の価格をご覧ください。

公開前の注意点

• ポーリングの代わりにコールバックを使う：リクエストのトップレベル（input と同じ階層）に "callback": {"url": "https://あなたのドメイン/hiapi/callback"} を追加し、taskId で重複排除します。
• 早めに転送保存：output[0].url は一時リンクです。
• リトライには冪等キーを付ける：リクエストヘッダーに Idempotency-Key を追加すると、同じキーでのリトライはタスクを1回だけ作成します。
• 失敗時は自動返金：成功した動画のみ課金されます。

よくある質問

なぜ 720p を渡すとエラーになるのですか？

解像度は大文字で書く必要があります。小文字を渡すと 400 が返ります：resolution: value must be one of '480P', '720P', '1080P'。

参照動画は渡せますか？

Prime は不可で、reference_video_urls パラメータを受け付けません。参照動画が必要なら、Wan 3.0 標準版 wan3.0-video に切り替えてください。

音声はオフにできますか？

できます、audio: false。デフォルトはオンで、価格は変わりません。

Prime と Wan 3.0 標準版の違いは何ですか？

パラメータと出力仕様は同じで、Prime は高速回線です。標準版にも 480P プラン（$0.04/秒）がありますが、720P と 1080P は毎秒2倍以上高く、参照動画も受け付けません。

その他のプロンプトの書き方は Wan 3.0 Prime プロンプト事例、前世代との比較は Wan 3.0 と Wan 2.7 の選び方をご覧ください。直接モデルページで雨夜の路地の这条を生成することもできます。