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

Gemini 画像モデル API

Gemini 3.1 Flash Image、Nano Banana 2.1、Gemini 3 Pro Image について、OpenAI 互換プロトコルと Gemini ネイティブプロトコルのリクエスト形式、アスペクト比、解像度、参照画像を説明します。

対象範囲

このページでは Gemini 画像モデルを説明します。OpenAI 画像モデルは OpenAI 画像モデル API、Grok 画像モデルは Grok 画像モデル API をご覧ください。

主な違い

Gemini 画像モデルは OpenAI Images API のモデルではありません。/v1/chat/completions または Gemini ネイティブの /v1beta/models/{model}:generateContent を使用し、/v1/images/generations や /v1/images/edits には送信しないでください。

モデルと機能

モデル解像度参照画像1 回の枚数課金
gemini-3.1-flash-image1K (既定) / 2K / 4K
image_config
最大 14 枚 (Data URI / 公開 URL)常に 1 枚1 回ごと
gemini-nano-banana-2.11K (既定) / 2K / 4K
image_config
最大 6 枚 (Data URI / 公開 URL)常に 1 枚1 回ごと
gemini-3-pro-image1K (既定) / 2K / 4K
image_config
最大 14 枚 (Data URI / 公開 URL)常に 1 枚1 回ごと

対応するアスペクト比:1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9

  • 3 つのモデルはいずれもリクエスト単位の課金で、料金は解像度や参照画像の枚数に関係ありません。
  • 1 リクエストにつき返される画像は 1 枚のみで、n、candidateCount は効きません。複数枚必要な場合は複数のリクエストを並行して送信してください。
  • gemini-nano-banana-2.1 では参照画像を 1 回あたり最大 6 枚にすることをおすすめします。それを超えた分は使われないことがあります。

実際に利用可能なモデルは、コンソールが返すモデルリストをご確認ください。

対応プロトコル

プロトコルエンドポイントリクエストボディの形式主な用途
OpenAI 互換プロトコル(推奨)POST /v1/chat/completionsmodel + messagesOpenAI SDK、汎用クライアント、ほとんどのアプリ
Gemini ネイティブプロトコルPOST /v1beta/models/{model}:generateContentcontents + generationConfigGemini SDK を直接使う場合やネイティブのフィールドが必要な場合

認証

OpenAI 互換プロトコルでは次のヘッダーを使用します:

Authorization: Bearer $API_KEY
Content-Type: application/json

Gemini ネイティブプロトコルでは、Gemini クライアントの慣例に従って x-goog-api-key リクエストヘッダーも使用できます。値は同じく 88API のトークンです。実際のキーをフロントエンドのコード、ログ、公開サンプルに書かないでください。

アスペクト比と解像度

アスペクト比と解像度は image_config で設定します:

  • aspect_ratio:上の機能表を参照してください。
  • image_size:1K(デフォルト)、2K、4K。大文字の K を使用してください。

各レベルの出力ピクセル:

比率1K2K4K
1:11024x10242048x20484096x4096
2:3848x12641696x25283392x5056
3:21264x8482528x16965056x3392
3:4896x12001792x24003584x4800
4:31200x8962400x17924800x3584
4:5928x11521856x23043712x4608
5:41152x9282304x18564608x3712
9:16768x13761536x27523072x5504
16:91376x7682752x15365504x3072
21:91584x6723168x13446336x2688
  • アスペクト比を指定しない場合は、モデルがプロンプトに応じて画面比率を選びます。参照画像がある場合は、デフォルトで 1 枚目の参照画像の比率に合わせます。サイズを固定したい場合は aspect_ratio を明示的に指定してください。
  • 出力は JPEG または PNG のどちらかです。拡張子を決め打ちせず、返された MIME タイプに従って保存してください。

OpenAI 互換プロトコル(推奨)

テキストから画像生成

curl https://api.88api.ai/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image",
    "messages": [
      {
        "role": "user",
        "content": "窓辺に座る茶トラ猫の画像を生成してください。午後の自然光、写実的な写真スタイル"
      }
    ],
    "extra_body": {
      "google": {
        "image_config": {
          "aspect_ratio": "16:9",
          "image_size": "2K"
        }
      }
    }
  }'

image_config の書き方

アスペクト比と解像度は必ず extra_body.google.image_config の中に書き、フィールド名は aspect_ratio、image_size(スネークケース)を使用してください。リクエストのトップレベルに書いた image_config、aspect_ratio、size は無視されます。imageConfig、aspectRatio などのキャメルケースで書くと拒否されます。

参照画像を渡す

curl https://api.88api.ai/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "messages": [
      {
        "role": "user",
        "content": [
          { "type": "text", "text": "1 枚目の画像の人物を参考に、同じ人物の映画ポスターを生成してください" },
          { "type": "image_url", "image_url": { "url": "data:image/png;base64,..." } }
        ]
      }
    ],
    "extra_body": {
      "google": { "image_config": { "aspect_ratio": "2:3", "image_size": "2K" } }
    }
  }'
  • image_url.url には Data URI または公開画像の URL を指定できます。Data URI には data:image/png;base64,... のように完全なメディアタイプのプレフィックスが必要です。
  • PNG、JPEG、WebP、GIF に対応し、BMP には対応していません。1 枚あたり 7 MB 以下をおすすめします。
  • 複数の参照画像は順番に並べ、プロンプトでは「1 枚目」「2 枚目」のように指定できます。

リクエストフィールド

フィールド型必須説明
modelstringはいGemini 画像モデル名。
messagesarrayはいOpenAI Chat Completions のメッセージ配列。通常は user メッセージ 1 件のみです。
messages[].contentstring または arrayはいテキストのみの場合は文字列、テキストと参照画像を組み合わせる場合はコンテンツ配列を使用します。
content[].image_url.urlstringいいえ参照画像。Data URI または公開 URL。
extra_body.google.image_config.aspect_ratiostringいいえアスペクト比。
extra_body.google.image_config.image_sizestringいいえ1K、2K、4K。

レスポンス

画像は Markdown の画像として choices[0].message.content に含まれます:

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "![image](data:image/jpeg;base64,/9j/4AAQ...)"
      },
      "finish_reason": "stop"
    }
  ]
}

content から data:<mime>;base64,... を取り出せば画像が得られます。レスポンスを /v1/images/generations の data 配列として解析しないでください。

Gemini ネイティブプロトコル

テキストから画像生成

curl "https://api.88api.ai/v1beta/models/gemini-3-pro-image:generateContent" \
  -H "x-goog-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "窓辺に座る茶トラ猫の画像を生成してください。午後の自然光、写実的な写真スタイル" }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": { "aspectRatio": "16:9", "imageSize": "2K" }
    }
  }'

参照画像

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "この画像を参考に、同じ人物の映画ポスターを生成してください" },
        { "inlineData": { "mimeType": "image/png", "data": "<BASE64_DATA>" } }
      ]
    }
  ],
  "generationConfig": {
    "imageConfig": { "aspectRatio": "2:3" }
  }
}

公開画像は fileData でも渡せます:{ "fileData": { "mimeType": "image/jpeg", "fileUri": "https://..." } }。

レスポンス

画像は candidates[0].content.parts[].inlineData にあり、mimeType が画像の種類、data が Base64 データです。

ストリーミングとタイムアウト

stream: true は使用できますが、画像は 1 つのイベントでまとめて返され、段階的なプレビューはありません。非ストリーミングのリクエストを使い、クライアントのタイムアウトを 5 分以上に設定することをおすすめします。4K 画像は通常 30〜60 秒かかり、混雑時はさらに時間がかかります。

誤ったリクエスト例

# 誤り:Gemini 画像モデルで OpenAI Images API のパスを使わないでください
curl https://api.88api.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image",
    "prompt": "茶トラ猫"
  }'

このようなリクエストには 请使用 Gemini 原生接口调用 / please use the Gemini native API(Gemini ネイティブ API を使用してください)が返されます。このページの Chat Completions 形式またはネイティブの generateContent 形式に切り替えてください。

よくあるエラー

エラー原因
请使用 Gemini 原生接口调用リクエストが /v1/images/* に送信されています。
extra_body.google.imageConfig is not supported, use extra_body.google.image_config insteadimage_config がキャメルケースで書かれています。
mime type is not supported by Gemini参照画像の形式(BMP など)に対応していません。
failed to download file参照画像の URL をダウンロードできません。リンクが公開アクセス可能か確認してください。
コンテンツ審査を通過できなかった旨の表示プロンプトや参照画像が安全審査を通過しなかったか、モデルがテキストのみを返して画像を生成しませんでした。プロンプトを調整して再試行してください。

上記の失敗したリクエストは課金されません。