> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Geminiネイティブ（画像、ストリーミング）

> ネイティブGeminiの画像ストリーミングリクエストとレスポンス処理。

ネイティブのstreamGenerateContentエンドポイントを使用して、Geminiの画像生成レスポンスをストリーミングします。リクエストフィールドはgenerateContentと同じです。

`POST https://api.mixroute.ai/v1/models/{model}:streamGenerateContent?alt=sse`

## モデル

| モデルID | 機能と制限 |
| - | - |
| `gemini-nano-banana-2.1` | Nano Banana 2.1。1K/2K/4K出力。思考レベルはMINIMAL/MEDIUM/HIGHで、デフォルトはMEDIUMです。 |
| `gemini-3.1-flash-image` | Nano Banana 2。512、1K、2K、4K出力。MINIMAL/HIGHの思考。 |
| `gemini-3.1-flash-image-preview` | Nano Banana 2。512、1K、2K、4K出力。MINIMAL/HIGHの思考。 |
| `gemini-3-pro-image` | Nano Banana Pro。1K、2K、4K出力と、画像・テキストの推論に対応。 |
| `gemini-3-pro-image-preview` | Nano Banana Pro。1K、2K、4K出力と、画像・テキストの推論に対応。 |
| `gemini-3.1-flash-lite-image` | Nano Banana 2 Lite。出力は1Kのみ。Google検索によるグラウンディングには非対応。 |
| `gemini-2.5-flash-image` | 初代Nano Banana。出力は約1Kです。imageSizeは省略してください。 |

リクエストボディでは、[Gemini画像生成](/ja/api-reference/endpoint/nano-banana)と同じフィールドおよびモデル制限を使用します。クエリ文字列に`alt=sse`を使用してください。ボディにstreamパラメーターを追加しないでください。

## 例

環境変数`MIXROUTE_API_KEY`にMixRouteのキーを設定してください。リクエストは`Authorization: Bearer ...`を使用します。編集前に、元画像のプレースホルダーをアクセス可能な画像またはローカルファイルに置き換えてください。

```bash theme={null}
curl --no-buffer --request POST "https://api.mixroute.ai/v1/models/gemini-nano-banana-2.1:streamGenerateContent?alt=sse" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "A clean product photograph of a red ceramic mug on a white background."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "1K"
    }
  }
}'
```

### Python

```python theme={null}
import base64
import json
import os
from pathlib import Path
import requests

payload = json.loads(r'''
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "A clean product photograph of a red ceramic mug on a white background."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "1K"
    }
  }
}
''')

def events(lines):
    data = []
    for line in lines:
        if line == "":
            if data:
                yield "\n".join(data)
                data.clear()
        elif line.startswith("data:"):
            value = line[5:]
            data.append(value[1:] if value.startswith(" ") else value)
    if data:
        yield "\n".join(data)

url = "https://api.mixroute.ai/v1/models/gemini-nano-banana-2.1:streamGenerateContent?alt=sse"
image_index = 0
with requests.post(url, headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]}, json=payload, stream=True, timeout=(30, 180)) as response:
    response.raise_for_status()
    response.encoding = "utf-8"
    for data in events(response.iter_lines(decode_unicode=True)):
        if not data.strip():
            continue
        if data.strip() == "[DONE]":
            break
        chunk = json.loads(data)
        if "error" in chunk:
            raise RuntimeError(chunk["error"])
        for candidate in chunk.get("candidates", []):
            for part in candidate.get("content", {}).get("parts", []):
                if part.get("thought"):
                    continue
                if "inlineData" in part:
                    inline = part["inlineData"]
                    if inline.get("data"):
                        extension = {"image/png": "png", "image/jpeg": "jpg", "image/webp": "webp"}.get(inline.get("mimeType"), "bin")
                        Path(f"image_{image_index}.{extension}").write_bytes(base64.b64decode(inline["data"], validate=True))
                        image_index += 1
                elif "text" in part:
                    print(part["text"], end="")
```

## レスポンス

candidates\[].content.parts\[]からテキストと画像のパートを読み取ります。画像は通常、mimeTypeとBase64データを持つinlineDataを使用します。モデルのターンを再利用する際はthoughtSignatureを保持してください。画像がない場合はpromptFeedbackとfinishReasonを確認します。usageMetadataにはトークン使用量が含まれ、画像生成の設定は含まれません。

[Geminiの同期画像リクエスト](/ja/api-reference/endpoint/nano-banana)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.