Wan 3.0

POST https://api.beatapi.io/v1/videos/tasks

480p・720p・1080p で、2～30 秒の動画を一度に生成します。このカタログで最も長いワンショットに対応しています。

対応する生成モード

参照入力： images は reference_videos または reference_audios と併用できません。参照動画と参照音声は、公開 API のトップレベルのフィールドで指定します。参照動画を含むリクエストには 1.5 倍の料金が適用されます。

非同期処理の流れ： タスクを作成して data.id を保存し、GET /v1/tasks/{task_id} でステータスをポーリングします。succeeded の場合は data.output.media から結果を取得します。failed の場合は data.error_code と data.error_message を確認し、エラーと再試行の方針に従って対処してください。

ローカルファイルを使う場合： 先に入力ファイルをアップロードし、返された data.url を指定してください。

認証

Authorization   string   必須

BeatAPI の API キーを Bearer トークンとして送信します。API キーはダッシュボードで作成できます。

Authorization: Bearer <BEATAPI_API_KEY>

通常の API キーは、信頼できるサーバーで管理してください。リクエストボディには Content-Type: application/json が必要です。対応するエンドポイントでは Idempotency-Key は任意ですが、同一のリクエストボディで安全に再試行するために指定を推奨します。

リクエストボディ

model   string   必須

wan-3.0 を指定してください。

固定値: wan-3.0

prompt   string   必須

動画生成の指示です。

文字数: 1 – 5000 文字

images   string[]   任意

公開 HTTPS 画像 URL です。1 枚の場合はその画像を開始フレームとして動画を生成し、複数の場合は画像参照として使われます。

要素数: 1 – 10 件

reference_videos   string[]   任意

公開 HTTPS 参照動画 URL です。参照動画を含むリクエストには 1.5 倍の料金が適用されます。

要素数: 1 – 5 件

reference_audios   string[]   任意

公開 HTTPS 参照音声 URL です。

要素数: 1 – 5 件

duration   integer   任意

出力動画の長さを秒単位で指定します。範囲内の任意の整数を指定でき、長い動画に対する追加料金はありません。

デフォルト値: 5
範囲: 2 – 30

aspect_ratio   enum<string>   任意

出力動画のアスペクト比です。

選択肢: 16:9, 9:16, 1:1, 4:3, 3:4
デフォルト値: "16:9"

resolution   enum<string>   任意

出力解像度の区分です。選択した解像度によって料金が変わります。

選択肢: 480p, 720p, 1080p
デフォルト値: "720p"

リクエスト例

テキストから動画を生成

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "wan-3.0",
  "prompt": "A slow dolly through a neon-lit night market in the rain, steam rising from food stalls.",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}'

画像から動画を生成

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "wan-3.0",
  "prompt": "The camera orbits the product as the light sweeps across it.",
  "images": [
    "https://media.beatapi.io/samples/smart-bottle.png"
  ],
  "duration": 20,
  "resolution": "1080p"
}'

参照素材を使用

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "wan-3.0",
  "prompt": "Match the motion of the reference clip and hold the subject for the full take.",
  "reference_videos": [
    "https://media.beatapi.io/inputs/motion.mp4"
  ],
  "duration": 30,
  "aspect_ratio": "9:16",
  "resolution": "480p"
}'

レスポンス

リクエストが成功すると、HTTP 201 が返されます。

{
  "data": {
    "id": "task_8K2qA",
    "object": "task",
    "task_kind": "video",
    "capability_id": "wan-3.0",
    "capability_version": null,
    "media_type": "video",
    "model": "wan-3.0",
    "status": "queued",
    "stage": "queued",
    "created_at": 1782210000,
    "updated_at": 1782210000,
    "completed_at": null,
    "output": null,
    "usage": {
      "credits_reserved": 0.63,
      "credits_charged": 0.63,
      "billable_duration_seconds": 5,
      "credits_settled": 0,
      "credits_refunded": 0
    },
    "request_id": "req_abc123",
    "error_code": null,
    "error_message": null
  }
}

エラー