API リファレンス

Wan 動画 API クイックスタート

API は Web アプリと同じモデル・料金・返金ルールで動画を生成します。生成はすべて非同期タスクです。送信したら、動画ができるまでポーリング（またはコールバックを受信）します。

API キーを取得Wan 3 API チーム · 2026年11月1日更新

ベース URLhttps://api.wan3api.org/v1

1. API キーを作成

ログインしてダッシュボードの「API キー」からキーを作成します。新規アカウントにはテスト用の無料クレジットがあり、いつでも買い切りのクレジットパックで追加できます。

shell

export API_KEY="sk-..."

2. タスクを送信

/videos/generations にプロンプトを POST します。タスク ID と消費クレジットがすぐに返ります。

curl -X POST "https://api.wan3api.org/v1/videos/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "wan-3",
  "prompt": "A red fox runs through fresh snow at sunrise, slow motion, cinematic",
  "duration": 5,
  "resolution": "480P",
  "aspect_ratio": "16:9"
}'

3. 動画を待つ

数秒ごとに GET /tasks/:id をポーリングするか、callback_url を渡して完了したタスクを受け取ります。多くは 1〜3 分で完了します。

# Poll every few seconds until status is "succeeded" or "failed".
curl "https://api.wan3api.org/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $API_KEY"

# Then download the video.
curl -L -o video.mp4 "$VIDEO_URL"

4. ダウンロード

status が succeeded になると video_url が MP4 を指します。ファイルは当社のストレージにコピーされるため、プロバイダーのリンクのように 1 時間で切れません。

json

{
  "id": "3f1c9a52-6d1e-4c1b-9a77-2f4d8f0c9e10",
  "object": "video.generation",
  "model": "wan-3",
  "mode": "text",
  "status": "succeeded",
  "progress": 100,
  "prompt": "A red fox runs through fresh snow at sunrise, slow motion, cinematic",
  "duration": 5,
  "resolution": "480P",
  "aspect_ratio": "16:9",
  "video_url": "https://api.wan3api.org/api/video/media/video/outputs/…/3f1c9a52.mp4",
  "credits": 15,
  "refunded": false,
  "error": null,
  "source": "api",
  "created_at": "2026-11-01T08:00:00.000Z",
  "completed_at": "2026-11-01T08:00:41.000Z"
}

次へ認証