OpenClaw で Grok Imagine を使えますか？

はい。OpenClaw に RunAPI が OpenAI 互換プロバイダーとして設定済みであれば、同じ API キーと /v1 エンドポイントで Grok Imagine が使えます。model を grok-imagine-text-to-image に設定して text_to_image エンドポイントを呼び出します。

Grok Imagine に別の API キーが必要ですか？

いいえ。チャットや他のモデルで使用している RUNAPI_API_KEY が Grok Imagine でもそのまま使えます。1 つのキーで RunAPI カタログの 113 以上のモデルすべてを利用できます。

Grok Imagine は非同期ですか、同期ですか？

非同期です。API は即座に task_id を返します。タスクが完了するまでタスクステータスエンドポイントをポーリングします。RunAPI SDK と CLI は自動的にポーリングを処理します。

Grok Imagine のコストは？

Grok Imagine は RunAPI 経由でタスクごとの課金です。現在の料金は RunAPI 料金ページで確認してください。生成に失敗した場合は課金されません。

OPENCLAW + GROK IMAGINE

OpenClaw で Grok Imagine を使う。

Grok Imagine は xAI の画像・動画生成スイートです。テキストから画像、画像から画像、テキストから動画、画像から動画に対応しています。OpenClaw エージェントはチャットで使用している RunAPI キーと /v1 エンドポイントを通じて呼び出します。追加スキルのインストールは不要です。

API キーを取得ドキュメントを読む

1 つの API キー · テキストから画像エンドポイント · 非同期タスクポーリング

Use RunAPI to generate an image with xAI Grok Imagine.

Requirements:
- Use the RunAPI API at https://runapi.ai/v1/text_to_image.
- Read the API key from RUNAPI_API_KEY environment variable.
- Set the model to "grok-imagine-text-to-image".
- Write a descriptive prompt for the image you want.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the output URL.

curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-text-to-image",
    "prompt": "a robot hand placing a chess piece on a board, dramatic side lighting, slow motion feel"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "grok-imagine-text-to-image"
}

curl コマンドをコピーしてテスト grok-imagine

仕組み

3 ステップで OpenClaw で Grok Imagine を使う

RunAPI を設定する

シェルプロファイルに RUNAPI_API_KEY 環境変数を設定します。OpenClaw でチャット用に RunAPI が設定済みであれば、同じキーで Grok Imagine が使えます。追加セットアップは不要です。

export RUNAPI_API_KEY=runapi_xxx

Grok Imagine を呼び出す

model を grok-imagine-text-to-image に設定してプロンプトを含めた POST リクエストを text_to_image エンドポイントに送ります。動画の場合は grok-imagine-text-to-video で text_to_video を使います。

text_to_image

結果を取得する

API は即座に task_id を返します。ステータスが completed に変わるまでタスクステータスエンドポイントをポーリングし、レスポンスから出力の画像または動画 URL を取得します。

task_id: tsk_abc123

パラメーター

Grok Imagine API パラメーター

パラメータ	型	説明
`model`	`string`	必須。例：grok-imagine-text-to-image、grok-imagine-image-to-video。
`prompt`	`string`	生成したい出力のテキスト説明。
`image_url`	`string`	画像から画像または画像から動画用のソース画像 URL。
`aspect_ratio`	`string`	省略可。出力アスペクト比（例：16:9、1:1）。

OpenClaw上のGrok Imagineとは？

Grok Imagine（Aurora）はxAIのGrokプラットフォームに内蔵された画像・動画生成器です。テキストプロンプトからリアルなポートレート、アニメ調イラスト、同期音声付き短編動画を生成します。OpenClaw agentはRunAPI経由で呼び出し、GrokやSuperGrokのサブスクリプションなしにテキスト→画像・画像編集・動画生成が可能です。