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-image | 1K (既定) / 2K / 4Kimage_config | 最大 14 枚 (Data URI / 公開 URL) | 常に 1 枚 | 1 回ごと |
gemini-nano-banana-2.1 | 1K (既定) / 2K / 4Kimage_config | 最大 6 枚 (Data URI / 公開 URL) | 常に 1 枚 | 1 回ごと |
gemini-3-pro-image | 1K (既定) / 2K / 4Kimage_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/completions | model + messages | OpenAI SDK、汎用クライアント、ほとんどのアプリ |
| Gemini ネイティブプロトコル | POST /v1beta/models/{model}:generateContent | contents + generationConfig | Gemini SDK を直接使う場合やネイティブのフィールドが必要な場合 |
認証
OpenAI 互換プロトコルでは次のヘッダーを使用します:
Authorization: Bearer $API_KEY
Content-Type: application/jsonGemini ネイティブプロトコルでは、Gemini クライアントの慣例に従って x-goog-api-key リクエストヘッダーも使用できます。値は同じく 88API のトークンです。実際のキーをフロントエンドのコード、ログ、公開サンプルに書かないでください。
アスペクト比と解像度
アスペクト比と解像度は image_config で設定します:
aspect_ratio:上の機能表を参照してください。image_size:1K(デフォルト)、2K、4K。大文字のKを使用してください。
各レベルの出力ピクセル:
| 比率 | 1K | 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 4096x4096 |
| 2:3 | 848x1264 | 1696x2528 | 3392x5056 |
| 3:2 | 1264x848 | 2528x1696 | 5056x3392 |
| 3:4 | 896x1200 | 1792x2400 | 3584x4800 |
| 4:3 | 1200x896 | 2400x1792 | 4800x3584 |
| 4:5 | 928x1152 | 1856x2304 | 3712x4608 |
| 5:4 | 1152x928 | 2304x1856 | 4608x3712 |
| 9:16 | 768x1376 | 1536x2752 | 3072x5504 |
| 16:9 | 1376x768 | 2752x1536 | 5504x3072 |
| 21:9 | 1584x672 | 3168x1344 | 6336x2688 |
- アスペクト比を指定しない場合は、モデルがプロンプトに応じて画面比率を選びます。参照画像がある場合は、デフォルトで 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 枚目」のように指定できます。
リクエストフィールド
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | はい | Gemini 画像モデル名。 |
messages | array | はい | OpenAI Chat Completions のメッセージ配列。通常は user メッセージ 1 件のみです。 |
messages[].content | string または array | はい | テキストのみの場合は文字列、テキストと参照画像を組み合わせる場合はコンテンツ配列を使用します。 |
content[].image_url.url | string | いいえ | 参照画像。Data URI または公開 URL。 |
extra_body.google.image_config.aspect_ratio | string | いいえ | アスペクト比。 |
extra_body.google.image_config.image_size | string | いいえ | 1K、2K、4K。 |
レスポンス
画像は Markdown の画像として choices[0].message.content に含まれます:
{
"choices": [
{
"message": {
"role": "assistant",
"content": ""
},
"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 instead | image_config がキャメルケースで書かれています。 |
mime type is not supported by Gemini | 参照画像の形式(BMP など)に対応していません。 |
failed to download file | 参照画像の URL をダウンロードできません。リンクが公開アクセス可能か確認してください。 |
| コンテンツ審査を通過できなかった旨の表示 | プロンプトや参照画像が安全審査を通過しなかったか、モデルがテキストのみを返して画像を生成しませんでした。プロンプトを調整して再試行してください。 |
上記の失敗したリクエストは課金されません。