テキストから画像への編集に加え、最大5枚のソース画像、自動またはピン留めの品質ティア、1Kまたは2Kの出力解像度に対応しています。
xAI画像生成リリース 2026年8月7日独自エンドポイント新着テキストから画像への編集に加え、最大5枚のソース画像、自動またはピン留めの品質ティア、1Kまたは2Kの出力解像度に対応しています。
別名 Grok Imagine Image, xAI Grok Imagine Image 2.0
grok-imagine-image-2-0/v1/images/generationsPOST/v1/images/editsgrok-imagine-image-2grok-imagine-image-2.0xai/grok-imagine-image-2-0xai/grok-imagine-image-2xai/grok-imagine-image-2.0EmpirioLabs カタログのライブ従量課金料金です。使った分だけの支払いで、月額最低料金はありません。
Grok Imagine Image 2.0 は POST /v1/images/generations で動作します。リクエストはすぐに job_id を返すので、ジョブが完了するまで GET /v1/jobs/{job_id} をポーリングし、結果から出力 URL を読み取ってください。 また、"sync": true を追加するとポーリングを省略できます。リクエストは開いたまま OpenAI 形式の完成した画像レスポンスを直接返すため、OpenAI SDK がそのまま動作します。 EmpirioLabs ダッシュボードで API キーを取得してください。
curl https://api.empiriolabs.ai/v1/images/generations \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-image-2-0",
"prompt": "Describe what you want Grok Imagine Image 2.0 to generate."
}'curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY"import requests
response = requests.post(
"https://api.empiriolabs.ai/v1/images/generations",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
json={
"model": "grok-imagine-image-2-0",
"prompt": "Describe what you want Grok Imagine Image 2.0 to generate.",
},
)
job = response.json()
# Generation runs as an async job. Poll until it completes.
import time
while True:
status = requests.get(
f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
).json()
if status.get("status") in ("completed", "failed"):
print(status)
break
time.sleep(5)EmpirioLabs 上の Grok Imagine Image 2.0 API が対応するリクエストパラメーターです。フィールドを省略した場合はデフォルト値が適用されます。
| パラメータ | タイプ | デフォルト | 範囲 / 値 | 説明 |
|---|---|---|---|---|
| prompt | string | - | - | 作成するイメージを説明してください。ソース画像を添付すると、これが編集指示となります。複数の画像を、などと呼びます<IMAGE_0><IMAGE_1>。最大8,000文字まで。 |
| image | array | - | - | 編集用のソース画像は1〜5枚、URLやデータURI、アップロードされた画像オブジェクトなどです。プロンプトだけで作成する場合は空のままにしてください。 |
| images | array | - | - | 複数の画像参照をアップロードするための複数形の別名。 |
| quality | enum | auto | auto, low, medium | レンダリング品質。自動でモデルが各リクエストのティアを選べるようにし、請求はそのティアに従って行われます。低リターンは数秒で済み、画像あたりのコストも低くなります。ミディアムは時間がかかり、より細かいディテールを解決できます。 |
| resolution | enum | 1k | 1k, 2k | 出力解像度の層。2kは1kよりも多くのピクセルをレンダリングし、1枚あたりのコストも高くなります。 |
| aspect_ratio | enum | auto | auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 21:9, 5:... | 出力アスペクト比。オートはモデルがプロンプトに最適なものを選べます。編集時は、オートが最初のソース画像に追随します。21:9および5:2のワイドスクリーンおよびバナーフォーマットを含みます。 |
| num_images | number | 1 | 1 から 10 | 出力画像の数。出力画像は別々に請求されます。 |
| response_format | enum | url | url, b64_json | 署名済み画像URLをデフォルトで返すか、b64_jsonが求められたらbase64画像データを含めることができます。 |
テキストプロンプトから画像を生成するか、自然言語命令から最大5つのソース画像を編集します。モード- テキストから画像へ:画像なしのプロンプトを送信。- 画像編集:1枚の画像を添付し、変更したい内容を説明します。- マルチ画像編集:2枚から5枚の画像を添付して被写体を合成したり、スタイルを転送したり、シーンを合成したりできます。プロンプト上でそれらを、などと呼びます<IMAGE_0><IMAGE_1>。例のマルチ画像プロンプト 「 Place the product from <IMAGE_0> onto the marble surface in <IMAGE_1>. 」 デフォルト - 1K解像度での自動品質 - 自動アスペクト比でモデルがプロンプトに最適なものを選ぶ - リクエストごとに1枚の画像を出力 品質と解像度 品質はレンダリングにどれだけ作業がかかるかを決定します。オートはモデルが各リクエストの階層を選択できるようにし、現在はテキストプロンプトには低、編集には中程度で対応しています。低は数秒で戻ります。中は時間がかかり、より細かい処理ができます。解像度は1Kまたは2Kの出力層を選択します。品質と解像度は4つの価格帯にまとめられているため、低品質の1K画像が最も安価で、中規模の2K画像が最も詳細です。コントロール プロンプト、ソース画像(URLまたはアップロード)、品質、解像度、アスペクト比を16の比率でサポートし、オートおよび21:9および5:2ワイドスクリーンフォーマット、画像数、レスポンス形式を含みます。制限 - 編集ごとに最大5枚のソース画像 - リクエストごとに最大10枚の出力画像 - 最大8,000文字までのプロンプト請求 - 出力画像ごとに提供された品質と解像度に応じて料金が請求され、添付した各画像ごとに料金がかかります。テキストから画像への変換にはソース画像手数料はありません。- 自動品質では、そのリクエストに対して提供されたモデルの階層に応じて料金が発生します。価格を事前に決めたい場合は、品質を低または中に設定してください。- 画像が生成される前に検証に失敗または拒否されたリクエストは請求されません。- 生成されたもののコンテンツポリシーでブロックされた画像は請求されます。これはxAI使用ポリシーに従い、コンテンツ安全チェックでブロックされても生成分を請求します。これにより、プロンプトや画像のソースは使用ポリシー内に収めてください。コンテンツ安全性 生成画像は自動コンテンツセーフティチェックに合格します。明示的にフラグが立てられた画像は返されません。チェックが実行される前に画像が生成されるため、フラグが立てられた生成は依然として請求されます。
EmpirioLabs では Grok Imagine Image 2.0 は従量課金です: 低品質、1K $0.048 画像ごと; 低品質、2K $0.072 画像ごと; 中程度の品質、1K $0.072 画像ごと; 中程度の品質、2K $0.096 画像ごと; 画像入力 $0.05 画像ごと。このページのライブ料金表は常に API の請求額と一致します。
Grok Imagine Image 2.0 は api.empiriolabs.ai 上の POST /v1/images/generations で提供され、標準的な Bearer トークン認証を使用します。
はい。EmpirioLabs プレイグラウンドでは API と同じパラメーターで Grok Imagine Image 2.0 をブラウザ上で実行できるので、コードを書く前にプロンプトを試せます。
EmpirioLabs アカウントを作成し、ダッシュボードの API Keysでキーを生成してください。課金は従量制クレジットなので、実行したリクエストの分だけ支払います。
