ナビゲーションにスキップ
動画 APIGrok Imagine

Grok Imagine Video 1.5

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

テキスト、1 枚の開始フレーム、または最大 7 枚の参照画像から、1～15 秒の動画を生成します。480p・720p・1080p に対応しています。1080p で指定できる画像は最大 1 枚です。

対応する生成モード

モード必須の入力入力ルール
テキストから動画を生成model, promptimages と reference_images は省略してください。
開始フレームを指定model, prompt, images画像 URL を 1 個指定し、aspect_ratio は省略してください。
参照画像を使用model, prompt, reference_images画像 URL を 1～7 個指定します。1080p で指定できる画像は最大 1 枚です。

非同期処理の流れ： タスクを作成して 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   必須

grok-imagine-video-1.5 を指定してください。

固定値: grok-imagine-video-1.5

prompt   string   必須

動画生成の指示です。

文字数: 1 – 4096 文字

images   string[]   任意

開始フレームの画像を、1 個の公開 HTTPS URL で指定します。

要素数: 1 – 1 件

reference_images   string[]   任意

1～7 枚の公開 HTTPS 参照画像です。

要素数: 1 – 7 件

duration   integer   任意

出力動画の長さを秒単位で指定します。

デフォルト値: 8
範囲: 1 – 15

aspect_ratio   enum<string>   任意

出力動画のアスペクト比です。開始フレームの画像を 1 枚指定する場合は省略してください。

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

resolution   enum<string>   任意

出力解像度の区分です。1080p で指定できる画像は最大 1 枚です。

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

リクエスト例

テキストから動画を生成

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "grok-imagine-video-1.5",
  "prompt": "A cinematic product reveal with a slow orbiting camera.",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "480p"
}'

開始フレームを指定

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "grok-imagine-video-1.5",
  "prompt": "Animate the performer with a slow push-in and native ambient sound.",
  "images": [
    "https://media.beatapi.io/samples/neon-singer.png"
  ],
  "duration": 8,
  "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": "grok-imagine-video-1.5",
  "prompt": "Keep the supplied identity consistent across a short cinematic shot.",
  "reference_images": [
    "https://media.beatapi.io/samples/neon-singer.png",
    "https://media.beatapi.io/samples/smart-bottle.png"
  ],
  "duration": 8,
  "aspect_ratio": "9:16",
  "resolution": "720p"
}'

レスポンス

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

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

エラー

ステータスコード意味と対処方法
400JSON の形式が不正、またはフィールド・値・組み合わせが未対応です（bad_request。メッセージにフィールド名が記載されます）。入力がコンテンツ審査で拒否された場合は content_policy_violation です。修正せずに再試行しても成功しません。
401API キーが未指定（missing_api_key）、またはキーが不正・期限切れ・無効・上限到達です（invalid_api_key。理由はメッセージに記載されます）。Authorization: Bearer <key> で送信してください。sk- 接頭辞の有無にかかわらず使えます。そのまま再試行しないでください。
402残高不足です（insufficient_credits）。残高がゼロ、またはこのリクエストの料金に足りません。残高をチャージしてから再度送信してください。それまでは再試行しないでください。
403キーまたはアカウントに、この呼び出しの権限がありません（forbidden）。例として、無料クレジットでは利用できないモデル（チャージすると利用可能）、キーの IP 許可リスト外からのリクエスト、キーのグループに含まれないモデルがあります。そのまま再試行しないでください。
409Idempotency-Key が別のリクエストボディで使用済み、または同じキーの最初のリクエストが処理中です（idempotency_conflict）。そのまま再試行しないでください。
429リクエスト数が上限を超えています（無料モデルの制限を含む rate_limit_exceeded）、または同時処理中のタスクが多すぎます（user_concurrency_exceeded）。Retry-After の秒数だけ待ってから再試行できます。同じ値は error.retry_after_seconds にも含まれます。
500予期しない内部エラーです（internal_error）。再試行できます。繰り返し発生する場合は、request_id を控えてサポートに連絡してください。
503リクエストを完了できませんでした（processing_unavailable、processing_timeout、processing_failed、result_transfer_failed）。課金されていません。待機時間を段階的に延ばして再試行できます。待機時間が判明している場合は Retry-After が返されます。BeatAPI は 502 や 504 を返しません。