API リファレンス
タスク状態 API：ポーリング・一覧・削除
タスクは 1 回の生成です。すべてのエンドポイントとコールバックが同じタスクオブジェクトを返します。
API キーを取得Wan 3 API チーム ·
タスクを取得
GEThttps://api.wan3api.org/v1/tasks/{id}
タスクを返し、処理中なら最新の状態を確認します。5〜10 秒ごとのポーリングがおすすめです。
curl "https://api.wan3api.org/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $API_KEY"ステータス
| status | |
|---|---|
processing | 送信済みで生成中。progress は 0 から 99 まで進みます。 |
succeeded | 完了。video_url が設定されています。 |
failed | 生成できませんでした。error に理由があり、refunded は true（クレジットは返金済み）です。 |
動画を待つ
# 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"タスク一覧
GEThttps://api.wan3api.org/v1/tasks?limit=20
API と Web アプリの両方のタスクを新しい順に返します。limit は 1〜50、既定 20。
curl "https://api.wan3api.org/v1/tasks?limit=20" \
-H "Authorization: Bearer $API_KEY"タスクを削除
DELETEhttps://api.wan3api.org/v1/tasks/{id}
完了したタスクと動画ファイルを削除します。処理中のタスクは 409 task_processing を返します。
curl -X DELETE "https://api.wan3api.org/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $API_KEY"タスクオブジェクト
credits は生成の費用、refunded は返金されたかどうか。source は api または web。日時は UTC の ISO 8601 です。
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"
}