NezhaGate
简体中文EnglishEspañol한국어日本語 ✓
ログイン API Key を取得
grok-imagine-video-1.5

Grok Imagine Video 1.5 · API

⧉Markdown としてコピー 📄Markdown として表示AI 用のプレーンテキスト ✦Open in ChatGPT ✶Open in Claude
POST https://nezhagate.com/v1/videos/generations

Grok Imagine Video 1.5 の動画生成（非同期）: duration は 4〜15 の任意の整数秒、解像度 480P / 720P、画面比率 16:9 / 9:16 / 1:1 / 4:3 / 3:4。image を渡すと画像から動画になります（参照は最大 7 枚、2 枚以上なら最長 10 秒）。ジョブ ID を返し（HTTP 202）、GET /v1/videos/jobs/{id} を status=succeeded になるまでポーリングすると、結果が data[0].url に入ります。1 本ごとの課金: 480P $0.30 / 720P $0.40（既定は 720P）。同じ等級の中では、もっとも短いクリップともっとも長いクリップが同じ料金です。失敗時は全額返金します。

Playground で試す →

認証

Header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

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

リクエストボディ

パラメータ種別必須説明
model string はい モデル ID。ここでは grok-imagine-video-1.5 です。
prompt string はい 動画の内容、カメラ、動きを説明するテキストプロンプト。最大 5000 バイト（UTF-8。漢字 1 文字は 3 バイト）。
duration integer いいえ 長さ（秒）。4〜15 の任意の整数で、既定は 15、つまり最長の値です。1 本ごとの課金なので、長さは価格を変えません。seconds とも書けます。 参照画像を 2 枚以上入れると、上限が 10 秒に下がります。
resolution string いいえ 解像度: 480P $0.30 / 720P $0.40（既定は 720P）。価格を決めるのは長さではなく解像度です。
size string いいえ 画面比率: 16:9 / 9:16 / 1:1 / 4:3 / 3:4（既定は 16:9）。aspect_ratio とも書けます。このモデルは 21:9 に対応していません。
image string いいえ 画像から動画：参照画像を渡してください（公開 URL、data: URI、base64）。省略するとテキストから動画になります。
images array いいえ 複数枚の参照画像。最大 7 枚です。上限を超えた場合は切り詰めずに拒否します。reference_images とも書けます。

リクエスト例

cURL
# 1) submit -> 202 {"id":"img_...","status":"queued"}
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "grok-imagine-video-1.5", "prompt": "a paper crane unfolding over a misty lake", "duration": 15, "resolution": "720P", "size": "16:9"}'
# image-to-video: also pass  "image": "https://example.com/ref.png"
# 2) poll every ~5s until status=succeeded, then read data[0].url
curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'

レスポンス

200 · JSON
{
  "id": "img_3f9a...c2",
  "object": "video.generation.job",
  "status": "queued",
  "model": "grok-imagine-video-1.5"
}

非同期の動画ジョブ（送信 → ポーリング）

モデルは 1 つで、種類はパラメータで選びます。tier=lite/fast/quality、resolution=720p/1080p/4k（1080p と 4k は quality が必要）、size=16:9/9:16、duration=4s/6s/8s。image パラメータを加えると画像から動画（最初のフレーム）になります。HTTP 202 とジョブ ID が返るので、status=succeeded になるまでポーリングし、結果を data[0].url から取得してください（再ホストした mp4。1〜2 分ほど）。

curl · 送信（テキストから動画）
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "grok-imagine-video-1.5", "prompt": "夕暮れにサーフィンをする猫", "tier": "quality", "resolution": "1080p", "size": "16:9", "duration": "8s"}'
画像から動画：image パラメータも渡してください（最初のフレームとして使う参照画像。公開 URL、data: URI、base64 のいずれか）。
レスポンス例
{ "id": "img_3f9a...c2", "object": "video.generation.job", "status": "queued", "model": "grok-imagine-video-1.5" }
curl · ポーリング
curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'
レスポンス例
{
  "id": "img_3f9a...c2",
  "object": "video.generation.job",
  "status": "succeeded",
  "model": "grok-imagine-video-1.5",
  "data": [{ "url": "https://img.nezhagate.com/i/9f86d081a8....mp4" }]
}

1 本ごとの課金で、失敗時は全額返金します。生成が失敗またはタイムアウトした場合、確保したクレジットは自動的に戻ります。

エラーコード

Code説明
401API Key が欠落または無効
402残高不足または Key が上限超過
400モデルまたはパラメータが非対応
429上流のレート制限
502すべての上流回線が失敗