Grok 画像モデル API
Grok Imagine 画像モデル(grok-imagine-image、2.0、quality、edit)のテキストから画像生成・画像編集エンドポイント、アスペクト比、解像度、参照画像、エラーを説明します。
対象範囲
このページでは Grok Imagine 画像モデルを説明します。動画モデルは Grok 動画 API をご覧ください。
エンドポイントの選択
Grok 画像モデルは OpenAI Images 互換のエンドポイントを使用します:
| 用途 | リクエストメソッド | エンドポイント |
|---|---|---|
| テキストから画像生成 | POST | /v1/images/generations |
| 画像編集(画像から画像生成) | POST | /v1/images/edits |
/v1/chat/completions と /v1/responses には対応していません。参照画像は /v1/images/edits でのみ渡せます。/v1/images/generations に含めても無視されます。
モデルと機能
| モデル | 解像度 | 参照画像 | 1 回の枚数 | 課金 |
|---|---|---|---|---|
grok-imagine-image | 1K (既定) / 2Kaspect_ratio + resolution | 最大 3 枚 (Data URI / 公開 URL / ローカルファイル) | 最大 10 枚 | 1 枚ごと |
grok-imagine-image-2.0 | 1K (既定) / 2Kaspect_ratio + resolution | 最大 3 枚 (Data URI / 公開 URL / ローカルファイル) | 最大 10 枚 | 1 枚ごと |
grok-imagine-image-quality | 1K (既定) / 2Kaspect_ratio + resolution | 最大 3 枚 (Data URI / 公開 URL / ローカルファイル) | 最大 10 枚 | 1 枚ごと |
grok-imagine-edit同一モデル: grok-imagine-image-quality | 1K (既定) / 2Kaspect_ratio + resolution | 最大 3 枚 (Data URI / 公開 URL / ローカルファイル) | 最大 10 枚 | 1 枚ごと |
対応するアスペクト比:auto (既定) / 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 2:1 / 1:2 / 19.5:9 / 9:19.5 / 20:9 / 9:20 / 21:9 / 5:2
| モデル | quality | response_format |
|---|---|---|
grok-imagine-image | 非対応 | b64_json / url |
grok-imagine-image-2.0 | low / medium / auto | b64_json / url |
grok-imagine-image-quality | 非対応 | b64_json / url |
grok-imagine-edit | 非対応 | b64_json / url |
- 4 つのモデルはいずれもテキストからの画像生成と画像編集の両方に対応しています。
grok-imagine-editとgrok-imagine-image-qualityは同じモデルで、出力結果も同じです。qualityパラメータはgrok-imagine-image-2.0でのみ有効です。- 正常に返された枚数で課金され、解像度や参照画像の枚数には関係ありません。
実際に利用可能なモデルは、コンソールが返すモデルリストをご確認ください。
認証
Authorization: Bearer $API_KEY
Content-Type: application/jsonアスペクト比と解像度
aspect_ratio:上の機能表を参照してください。デフォルトはautoで、モデルがプロンプトに応じて画面比率を選ぶため、同じプロンプトでも毎回同じ比率になるとは限りません。サイズを固定したい場合は明示的に指定してください。resolution:1k(デフォルト)または2k。4K には対応していません。
各レベルの出力ピクセル(4 モデル共通):
| 比率 | 1K | 2K |
|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 |
| 16:9 | 1280x720 | 2816x1584 |
| 9:16 | 720x1280 | 1584x2816 |
| 4:3 | 1152x864 | 2368x1776 |
| 3:4 | 864x1152 | 1776x2368 |
| 3:2 | 1248x832 | 2496x1664 |
| 2:3 | 832x1248 | 1664x2496 |
| 2:1 | 1408x704 | 2912x1456 |
| 1:2 | 704x1408 | 1456x2912 |
| 19.5:9 | 1248x576 | 2912x1344 |
| 9:19.5 | 576x1248 | 1344x2912 |
| 20:9 | 1280x576 | 3200x1440 |
| 9:20 | 576x1280 | 1440x3200 |
| 21:9 | 1568x672 | 3136x1344 |
| 5:2 | 1600x640 | 3200x1280 |
- 1K の出力は JPEG、2K の出力は PNG で、
output_formatでは変更できません。 - OpenAI でおなじみの
size(例:1024x1024)も使用でき、自動的に換算されます。長辺が 1024 以下なら1k、それを超えると2kとなり、比率は対応値の中で最も近いものが選ばれます。そのため、返されるピクセル数がリクエストしたsizeと一致するとは限りません。1536x1024、1792x1024はどちらも2kで出力されます。 sizeとaspect_ratio/resolutionを同時に指定した場合は、aspect_ratio/resolutionが優先されます。
テキストから画像生成
curl https://api.88api.ai/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-image",
"prompt": "雨の夜、ネオンに照らされた東京の街角、映画のような雰囲気、写実的な写真",
"aspect_ratio": "16:9",
"resolution": "2k",
"n": 1
}'リクエストパラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | はい | モデル名。 |
prompt | string | はい | 画像の説明。空にはできません。数千字以内に収めることをおすすめします。 |
aspect_ratio | string | いいえ | アスペクト比。デフォルトは auto。 |
resolution | string | いいえ | 1k(デフォルト)または 2k。 |
n | integer | いいえ | 生成枚数。1 から 10、デフォルトは 1。 |
response_format | string | いいえ | b64_json(デフォルト)または url。url を指定すると 88API の画像リンクを返します。 |
quality | string | いいえ | grok-imagine-image-2.0 のみ:low、medium、auto(デフォルト。生成時は low、編集時は medium として扱われます)。medium は生成に時間がかかります。 |
style、seed、negative_prompt、background、output_format、stream などのパラメータは無視されます。
レスポンス例
{
"created": 1760000000,
"data": [
{ "b64_json": "/9j/4AAQ...", "mime_type": "image/jpeg" }
]
}レスポンスには revised_prompt は含まれません。
画像編集
JSON リクエスト(推奨、複数の参照画像に対応)
参照画像が 1 枚なら image、複数なら images 配列を使用します。最大 3 枚です:
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-image-quality",
"prompt": "1 枚目の人物を 2 枚目のシーンに配置する。人物の外見は変えない",
"images": [
"data:image/png;base64,...",
"https://example.com/scene.jpg"
],
"resolution": "2k"
}'- 参照画像には Data URI、または公開されていて直接ダウンロードできる URL を使用できます。Base64 には
data:image/...;base64,プレフィックスが必要です。 - JPG、PNG、WebP に対応し、GIF、BMP には対応していません。
imageを配列にしたり、imageとimagesを同時に指定したりしないでください。- 参照画像には渡した順に番号が付くため、プロンプトでは「1 枚目」「2 枚目」のように指定できます。
- アスペクト比を指定しない場合、出力の比率は 1 枚目の参照画像に合わせられ、解像度はデフォルトで
1kになります。aspect_ratio、resolutionで上書きできます。
multipart アップロード(1 枚のみ)
ローカルファイルは multipart でもアップロードできますが、1 回に 1 枚まで、1 ファイルあたり 20 MB 以下です:
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-F "model=grok-imagine-image" \
-F "image=@input.png" \
-F "prompt=背景を海辺の夕日に変える" \
-F "aspect_ratio=1:1"複数の参照画像が必要な場合は JSON リクエストを使用してください。
制限事項
maskによる部分的な再描画には対応していません。渡したマスクは無視されます。- ストリーミング出力や非同期での結果取得には対応していません。
- 出力画像には C2PA コンテンツクレデンシャル(AI 生成であることを示す情報)が付与されます。目に見える透かしはありません。
よくあるエラー
| ケース | HTTP | 返されるメッセージ |
|---|---|---|
| チャットまたは Responses エンドポイントを呼び出した | 400 | <模型> 是生图模型,不支持 <接口> 接口。请改用:POST /v1/images/generations, POST /v1/images/edits |
| 対応していないアスペクト比 | 400 | 不支持的图片比例。支持:… |
対応していない解像度(例:4k) | 400 | 不支持的图片分辨率。resolution 仅支持 1k 或 2k,请使用小写格式。 |
n が 1〜10 の範囲外、prompt が空、image と images を同時に指定、multipart で複数枚を送信 | 400 | 上游拒绝了请求参数(invalid-argument),请检查模型名、调用接口和请求参数 |
| 参照画像の形式に非対応、Base64 にプレフィックスがない、URL をダウンロードできない | 400 | 参照画像に関するエラーメッセージ |
| 参照画像が 3 枚を超えている | 502 | Upstream request failed |
| コンテンツ審査を通過できなかった | 400 | 图片生成未通过内容安全审核,请修改提示词或参考素材后重试。 |
表中のメッセージは API が実際に返す原文(簡体字中国語)です。上記の失敗したリクエストは課金されません。