Gemini 画像生成

概要

AIone は Gemini 画像生成モデルに対応しており、OpenAI Compatible の /v1/chat/completions エンドポイントから統一的にアクセスできます。

これらのモデルはゲートウェイ内部で自動的に Gemini ネイティブの画像生成パイプラインに切り替わり、OpenAI 互換のレスポンスフォーマットに変換して返します。そのためリクエスト方法は統一されたままですが、画像生成関連のパラメータを追加で使用できます。

現在接続済みの画像モデル

以下の Gemini 画像モデルが現在利用可能です：

gemini-3-pro-image-preview

gemini-3-pro-image-preview-2k

gemini-3-pro-image-preview-4k

gemini-2.5-flash-image

gemini-3.1-flash-image-preview

モデル名が不明な場合は、GET https://api.nexara.net/v1/models および Portal のモデル一覧ページを基準にしてください。

最小限のリクエスト例

補足：

aspect_ratio や image_size を指定しなくても正常に画像を生成できます

レスポンスは OpenAI 互換の chat.completion 構造のままです

アスペクト比とサイズパラメータ付きの例

対応リクエストパラメータ

汎用パラメータ

model：画像モデル ID

messages：会話メッセージの配列。引き続き OpenAI Chat Completions フォーマットに準拠

max_tokens / max_completion_tokens：Gemini ネイティブの maxOutputTokens にマッピングされます

temperature

top_p

top_k

画像関連パラメータ

aspect_ratio：Gemini ネイティブの imageConfig.aspectRatio にマッピングされます

image_size：Gemini ネイティブの imageConfig.imageSize にマッピングされます

これらのパラメータを指定しなくても正常に画像を生成できます。

参考画像の入力

参考画像を渡す必要がある場合は、OpenAI スタイルのマルチモーダル messages.content を使用できます：

{
  "model": "gemini-3-pro-image-preview",
  "messages": [
    {
      "role": "user",
      "content": [
        {"type": "text", "text": "この画像の構図を参考にして、窓辺に座る猫を描いてください"},
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,iVBORw0KGgoAAA..."
          }
        }
      ]
    }
  ],
  "max_tokens": 4096
}

注意：

現在のゲートウェイでは、Gemini ネイティブパイプラインについて data: URI フォーマットの image_url.url のみを保証しています

公開 URL を直接渡した場合、ゲートウェイはそれを Gemini ネイティブの画像入力に変換しません

レスポンスの説明

画像モデルが返す choices[0].message.content は通常の文字列ではなく、配列の場合があります：

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "gemini-3-pro-image-preview",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": [
          {"type": "text", "text": "生成した画像です："},
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/png;base64,AAAA..."
            }
          }
        ]
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 456,
    "total_tokens": 579
  }
}

これは以下を意味します：

一部のレスポンスには説明テキストと画像の両方が含まれます

画像コンテンツは image_url.url で返され、通常は data:image/...;base64,... フォーマットです

usage フィールドも返されるため、コンソールとレスポンスの両方で消費量を確認できます

制限事項と注意事項

/v1/chat/completions のみ対応：Gemini 画像モデルは /v1/messages をサポートしていません

ストリーミングレスポンス非対応：stream は false または未指定にしてください

レスポンス内容が配列の可能性：choices[0].message.content が必ずプレーンテキスト文字列であると仮定しないでください

モデル権限：API キーが対応する画像モデルへのアクセス権限を持っていることを確認してください

モデルの選択：2K / 4K バリアントを明示的に使用したい場合は、gemini-3-pro-image-preview-2k または gemini-3-pro-image-preview-4k を直接選択できます

14 - Gemini画像生成

Gemini 画像生成#

概要#

現在接続済みの画像モデル#

最小限のリクエスト例#

アスペクト比とサイズパラメータ付きの例#

対応リクエストパラメータ#

汎用パラメータ#

画像関連パラメータ#

参考画像の入力#

レスポンスの説明#

制限事項と注意事項#