88API88API
使用ガイドAIアプリケーションAPIリファレンスヘルプとサポート
画像(Image)

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-image1K (既定) / 2K
aspect_ratio + resolution
最大 3 枚 (Data URI / 公開 URL / ローカルファイル)最大 10 枚1 枚ごと
grok-imagine-image-2.01K (既定) / 2K
aspect_ratio + resolution
最大 3 枚 (Data URI / 公開 URL / ローカルファイル)最大 10 枚1 枚ごと
grok-imagine-image-quality1K (既定) / 2K
aspect_ratio + resolution
最大 3 枚 (Data URI / 公開 URL / ローカルファイル)最大 10 枚1 枚ごと
grok-imagine-edit
同一モデル: grok-imagine-image-quality
1K (既定) / 2K
aspect_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

モデルqualityresponse_format
grok-imagine-image非対応b64_json / url
grok-imagine-image-2.0low / medium / autob64_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 モデル共通):

比率1K2K
1:11024x10242048x2048
16:91280x7202816x1584
9:16720x12801584x2816
4:31152x8642368x1776
3:4864x11521776x2368
3:21248x8322496x1664
2:3832x12481664x2496
2:11408x7042912x1456
1:2704x14081456x2912
19.5:91248x5762912x1344
9:19.5576x12481344x2912
20:91280x5763200x1440
9:20576x12801440x3200
21:91568x6723136x1344
5:21600x6403200x1280
  • 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
  }'

リクエストパラメータ

パラメータ型必須説明
modelstringはいモデル名。
promptstringはい画像の説明。空にはできません。数千字以内に収めることをおすすめします。
aspect_ratiostringいいえアスペクト比。デフォルトは auto。
resolutionstringいいえ1k(デフォルト)または 2k。
nintegerいいえ生成枚数。1 から 10、デフォルトは 1。
response_formatstringいいえb64_json(デフォルト)または url。url を指定すると 88API の画像リンクを返します。
qualitystringいいえ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 枚を超えている502Upstream request failed
コンテンツ審査を通過できなかった400图片生成未通过内容安全审核,请修改提示词或参考素材后重试。

表中のメッセージは API が実際に返す原文(簡体字中国語)です。上記の失敗したリクエストは課金されません。