Wan 3.0 Prime · API

クイックスタート

3 ステップで動きます：タスクを送信 → 結果を照会 → 動画のリンクを受け取る。YOUR_API_KEY をご自身のキーに置き換えれば、下のコマンドはそのまま実行できます。

ステップ 1 · タスクを送信（すぐにタスク ID が返ります。HTTP 202）

curl https://nezhagate.com/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "wan3.0-video-prime", "prompt": "桜の木の下で舞い落ちる花びらを追いかける柴犬、明るい日差し、スローモーション", "duration": 5, "resolution": "720P", "size": "16:9"}'

レスポンス（HTTP 202）

{
  "id": "img_5c2e8f1a9b3d7e6f0a4c8b2d",
  "object": "video.generation.job",
  "status": "queued",
  "created": 1791281400,
  "model": "wan3.0-video-prime"
}

ステップ 2 · status が succeeded か failed になるまで、5〜10 秒ごとに照会

curl https://nezhagate.com/v1/videos/jobs/img_5c2e8f1a9b3d7e6f0a4c8b2d \
  -H "Authorization: Bearer YOUR_API_KEY"

成功時のレスポンス

{
  "id": "img_5c2e8f1a9b3d7e6f0a4c8b2d",
  "object": "video.generation.job",
  "status": "succeeded",
  "created": 1791281400,
  "model": "wan3.0-video-prime",
  "data": [
    {"url": "https://img.nezhagate.com/i/8c1f0e5d2b7a49e3a6d0c4f1b9e2a7d5.mp4"}
  ],
  "usage": {"clips": 1, "model": "wan3.0-video-prime"}
}

ステップ 3 · data[0].url が動画（MP4）のリンクです。保存期間は 15 日間なので、長く使う場合はご自身のストレージにダウンロードしてください。

完全なサンプル（Python：送信 → 待機 → ローカルに保存）

import time
import requests

BASE = "https://nezhagate.com/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

# 1. タスクを送信
job = requests.post(f"{BASE}/videos/generations", headers=HEADERS, json={
    "model": "wan3.0-video-prime",
    "prompt": "桜の木の下で舞い落ちる花びらを追いかける柴犬、明るい日差し、スローモーション",
    "duration": 5,
    "resolution": "720P",
    "size": "16:9",
}).json()
if "error" in job:
    raise SystemExit(job["error"]["message"])

# 2. 10 秒ごとに照会（最長 1 時間）
deadline = time.time() + 3600
while job["status"] not in ("succeeded", "failed") and time.time() < deadline:
    time.sleep(10)
    job = requests.get(f"{BASE}/videos/jobs/{job['id']}", headers=HEADERS).json()

# 3. 動画をダウンロード
if job["status"] == "succeeded":
    url = job["data"][0]["url"]
    with open("wan3.0-video-prime.mp4", "wb") as f:
        f.write(requests.get(url).content)
    print("saved", url)
elif job["status"] == "failed":
    print("failed:", job["error"]["code"], job["error"]["message"])
else:
    print("still", job["status"], job["id"])

順番待ちの間は、照会結果に queue_position（前に並んでいるタスクの数）と eta_seconds（予想待ち時間）も含まれます。設定した待ち時間の上限を過ぎても、再送信はしないでください。タスクは残っているので、しばらくしてから同じタスク ID で照会を続けてください。

認証

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

コンソールで API Key を作成すると利用を開始できます。

仕様早見表

リクエストパラメータ

POST /v1/videos/generations のリクエスト本文（JSON）：

そのほかのフィールド（seed、negative_prompt、fps、watermark など）はモデルに渡されず、料金にも影響しません。結果は常に MP4 で、url として返ります。

料金

秒単位の課金です：料金 = 選んだ解像度の 1 秒あたりの単価 ×（出力の秒数 + 各参照動画の秒数）。参照画像と参照音声は無料です。送信時に確保し、失敗時は全額返金します。1 クレジット = $0.005 です。

480P / 720P / 1080P のグレードはまだ公開されておらず、送信すると 400 で拒否されます。公開されると、この表は自動で更新されます。

参照素材

• 1 つのエンドポイントで、パラメータによってモードが切り替わります。画像なしならテキストから動画、画像 1 枚なら最初のフレーム、画像 2 枚に image_role: first_frame を付けると最初と最後のフレーム（1 枚目が最初、2 枚目が最後）になります。付けない場合、2 枚以上はすべて参照になり、最大 10 枚です。
• 参照動画は最大 5 本（合計 15 秒まで。それぞれに duration が必要）で、その映像を作り変えたり、続きを生成したりするのに使います。参照動画があるときは、画像は参照としてのみ使え、フレームにはできません。参照音声は最大 5 本で、公開された URL のみ受け付けます。
• 最初のフレームを指定する場合、size: adaptive にすると、動画がその画像の比率に合わせて生成されます。 人物の顔に関する審査制限：実在の人物の顔を含む参照素材は避けてください。写実的な顔も検出される場合があります。FaceDetectionSuspect は実在の人物の顔が含まれる可能性、DataInspectionFailed は入力素材が審査を通過しなかったことを示し、サービス停止を意味しません。同じ入力を繰り返さず、参照素材を変更して再送してください。誤判定が疑われる場合はサポートにご連絡ください。失敗したタスクは課金されません。
• 画像はそれぞれ、公開されている画像の URL、data: URI、base64 のいずれかで、1 枚 16MB までです。複数枚は配列にして images で渡します。当サイトで画像を保存してから、タスクを順番待ちに入れます。読み込めない画像があると 400 で拒否され、どの画像かが message に示されます。この場合は課金されません。
• 当サイトで保存した参照素材は 7 日間、生成結果は 15 日間保存されます。

最初と最後のフレーム：2 枚の画像をつなぐトランジション

curl https://nezhagate.com/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "wan3.0-video-prime", "prompt": "夜明けから夕暮れへと移り変わり、雲が流れ、光がしだいに暖かくなっていく", "images": ["https://example.com/first.png", "https://example.com/last.png"], "image_role": "first_frame", "duration": 5, "resolution": "720P", "size": "adaptive"}'

image_role: first_frame で 2 枚の画像を最初と最後のフレームにし、size: adaptive で動画を最初の画像の比率に合わせます。image_role を付けない場合、2 枚の画像は参照になります。

タスクの状態と返却フィールド

GET /v1/videos/jobs/{id} は次のステータスを返します。各フィールドの説明は 非同期タスク をご覧ください。5〜10 秒ごとに照会するか、下の Webhook で結果を受け取ってください。ポーリングは無料で、同じアカウントのキーならどれでもこのタスクを照会できます。

• processing が queued に戻ることがあります。たとえば、すべての回線が混み合っているとき、完成した動画を取得し直しているとき、サービスの再起動後などです。ある回線でタスクを完了できなかった場合、ゲートウェイが次の回線に回して生成し直すことがあります。いくつの回線を経由しても、課金は 1 タスクにつき 1 回だけです。
• 1 つのアカウントで同時に生成できるタスクは 50 件までで、それ以上は送信順に順番待ちになります。15 分たっても始まらないタスクは失敗となり、全額返金されます。タスクの記録は 3 日間、動画のリンクは 15 日間保存されます。

生成にかかる時間

ふつう 1〜3 分で、標準の Wan 3.0 より速く仕上がります。

エラーと返金

送信時のエラーはすぐに HTTP 4xx / 5xx で返り、タスクは作成されず、課金もされません。受け付け後の失敗は照会エンドポイントで報告され、確保額は全額返金されます。すべてのコードは エラーコード に載っています。

送信時に返るエラー

失敗したタスク（status が failed）

判定は message の文面ではなく code で行ってください。知らない code の場合（または code がない場合）は upstream_error として扱ってください。たいていは再送信すれば成功します。失敗したタスクはすべて全額返金されます。

ポーリングの代わりに Webhook を使う

送信時に callback_url を付けると、タスクが終わった時点で（成功・失敗とも）、照会エンドポイントが返すものとまったく同じ内容をゲートウェイがその URL へ送ります。署名付きで、届かなかった場合は自動で再試行します。コンソールの「設定 → Webhook」で、アカウント全体の送信先を設定することもできます。 Webhook のドキュメント →

curl https://nezhagate.com/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "wan3.0-video-prime", "prompt": "桜の木の下で舞い落ちる花びらを追いかける柴犬、明るい日差し、スローモーション", "duration": 5, "resolution": "720P", "size": "16:9", "callback_url": "https://your-domain.com/webhook"}'