シリーズの概要
この3つは、1つの点を除いて同じパラメータを受け付けます。
grok-imagine-image-2.0
だけがqualityを受け付けます。他の2つでは、品質が選択式ではなく固定されているため、
unknown fieldとして拒否されます。
これが、3つの中から選ぶ際の基本的な判断基準です。
- **
grok-imagine-image-2.0**は調整可能なモデルです。コストと忠実度のバランスを取りたい場合や、特定のアスペクト比と解像度が必要な場合に使用してください。 - **
grok-imagine-image-quality**は高品質に固定されており、デフォルトでは縦長の構図になります。制御性よりも品質を重視する場合に使用してください。 - **
grok-imagine-image**は3つの中で圧倒的に低コストです。下書き、サムネイル、その他大量に生成するものに使用してください。
パラメーター
エンベロープは、非同期タスク API で説明したmodel、input、およびオプションのcallback_urlという同じ3つのキーで構成されます。以下の内容はすべてinput内に指定します。
input内のバリデーションは厳格です。認識されないキーは直ちに拒否され、
invalid_paramsおよびキー名を正確に示すparamが返されます。誤字は黙って無視されず、
明確にエラーになります。
解像度と品質
grok-imagine-image-2.0では、2つの寸法は独立しており、どちらも出力に影響します。測定したピクセルサイズの例（各1件）：
残り2つのモデルでは
resolutionのみ適用されます。測定結果：2kでgrok-imagine-imageを指定すると2816 × 1584、2kでgrok-imagine-image-qualityを指定すると
1776 × 2368が返されます。
正確なピクセル寸法は固定グリッドではなく、モデルが決定します。同じ
ティアでも、指定するアスペクト比によって異なる数値になります。
この表はおおよその目安として扱い、実際のサイズはファイルから確認してください。
アスペクト比
3つのモデルはすべて同じ16種類の値に対応しています。
省略すると、各モデルは独自のデフォルトフレーミングを使用します。
grok-imagine-imageとgrok-imagine-image-2.0では横長、grok-imagine-image-qualityでは縦長です。autoを使用すると、モデルがプロンプトに基づいて選択します。
参照画像
input.images に最大3枚の画像を渡して、編集または合成に使用できます。各
エントリは、https URL または base64 データ URI のいずれかです。
input.images — must contain at most 3 items。形式が不正なエントリは、その
インデックスを示します: input.images[0] — must be an https URL or a base64 image data URI。
WideRouter はURLをサーバー側で取得するため、URLは公開インターネットから
アクセス可能である必要があります。名前解決できないホストや、画像以外の
ものを返すホストの場合、送信時ではなくキューに追加された後にタスクが失敗します。
Pricing
These models are served through theGrok-Official group. WideRouter’s list
price matches xAI’s official price exactly — the discount lives in the group
multiplier, which is 0.8 for Grok-Official. So what you pay is:
Two rules that are easy to miss:
- Reference images cost extra, about $0.01 per input image, on top of the output price. A three-image composition is priced as one output plus three inputs.
nmultiplies. Four images at2k/mediumis four times the single-image price, not a bulk rate.
A completed task carries
usage.cost_in_usd_ticks, where 10000000000 ticks
is $1. That figure is the list price — before your group multiplier.
Multiply it by your group’s rate to get what actually leaves your balance.レイテンシー
非同期 API でエンドツーエンドの時間を測定しました。completed への送信から、デフォルト設定で各 1 サンプルを実行した結果です。
十分に高速であるため、非同期のラウンドトリップ（送信後、2～3 秒ごとにポーリング）にかかる実時間は、生成自体にかかる時間を上回ることがよくあります。通常は 2 回のポーリングで完了します。
同期サーフェス
3つのモデルはすべてPOST /v1/images/generations でも応答し、接続を開いたままにして画像を直接返します。
data と usage で構成されます。data[0] に格納される内容は
response_format によって異なります。インラインのバイト列の場合は b64_json、リンクの場合は url です。
同期パスは、バイト列をすぐに受け取りたいスクリプトにはより簡単ですが、生成が完了するまで接続を保持します。2k での実測時間は 19.4 秒でした。サーバーレス関数、リバースプロキシ、またはモバイルクライアントの背後で動作するものは、代わりに非同期 API を使用してください。
次のステップ
Playground
ブラウザから実際のリクエストを送信し、タスクが完了する様子を確認します。
Grok Imagine 動画
ファミリーの動画機能です。クリップの生成、編集、延長に対応しています。