Grok Imagine の画像と動画

Grok Imagine には 2 つの系列があります。同期の OpenAI Images エンドポイントを使う画像生成と、非同期タスクエンドポイントを使う動画です。パラメータはこの 2 系列間で共通しません。

画像

エンドポイントとモデル

レスポンスは data[].url に一時的なダウンロードリンクを返します。受け取ったらすぐにダウンロードして保存してください。レスポンスにトークン使用量は含まれず、空のレスポンスは画像が生成されなかったことを意味します。OpenAI SDK を使ってローカルファイルをアップロードすることも可能です。マルチパート形式と JSON 形式の編集リクエストは全く同じフィールドを受け付け、どちらか一方でしか効かないパラメータはありません。

パラメータ

縦横比と実際の出力サイズ

aspect_ratio が形状を決め、resolution が画素数の予算を決めます(1k で約 100 万画素、2k で約 400 万画素)。grok-imagine-image を resolution: 1k で実行した際の実測出力サイズは以下のとおりです。

9:19.5、20:9、9:20 も有効な値ですが、上表にはその実測サイズを記載していません。resolution: 2k は同じ形状を保ったまま画素数の予算を引き上げます。例えば 16:9 は 2816×1584、1:1 は 2048×2048 になります。

curl

# Text to image
curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "An orange cat asleep on a sunlit windowsill, magazine photography",
    "aspect_ratio": "16:9",
    "resolution": "2k",
    "n": 1
  }'

# Image to image / editing (at most 2 reference images)
curl https://api.hop-base.com/v1/images/edits \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "Replace the background with a seaside at dusk, keep the subject",
    "image": ["https://example.com/source.png"],
    "aspect_ratio": "3:2",
    "resolution": "1k"
  }'

課金対象

課金は返された画像 1 枚ごとに、resolution ティア単位で発生します。ピクセル寸法から逆算されることはないため、返された画像のサイズを見て料金を計算する必要はありません。

動画

grok-imagine-video-1.5 はテキストから動画を生成するモデルで、参照画像をオプションで指定できます。先頭・末尾フレームの指定はなく、参照動画や参照音声もありません。

パラメータ

この表にないフィールドは拒否されます。

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "An orange cat runs across sunlit grass as the camera follows",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

送信に成功すると 200 が返り、タスク ID が task.id(vt… の形式)に入っています。GET /v1/video/tasks/{task_id} でポーリングしてください。status は pending、processing、completed、failed のいずれかで、終了状態は completed と failed のみです。それ以外の値は実行中として扱ってください。完了したタスクには duration_seconds と outputs 内の動画 URL が含まれ、完成した映像の秒数に応じて課金されます。outputs は完了から 30 日間有効で、再度クエリしても有効期限は延長されません。期限切れの URL は 410 を返します。失敗したタスクは課金されません。送信時の残高チェック(不足時は 402)など、すべての動画タスクに共通するルールは動画生成を参照してください。

プランと関連ページ

画像とチャットは Grok Suite(Grok 総合)プランから、動画は Grok Video プランから提供されます。これらは別々の 2 つのプランであり、一方に紐づいたキーは他方には到達しません。実際に使用するキーで GET /v1/models を呼び出して確認してください。Grok のチャット・推論モデル(長コンテキストの料金、推論トークンの計上、サーバー側ツールの課金を含む)については Grok を参照してください。

料金

公式のリスト価格は料金ページに掲載されています。実際の適用レートはログイン後のモデル広場に表示され、各リクエストの実際の課金額はコンソールの使用状況ページで確認できます。