Gemini ネイティブ

Stream Generate Content

Google Gemini API形式を使用したコンテンツ生成のストリーミング

POST
/v1beta/models/{model}:streamGenerateContent

Geminiの generateContent のSSEバージョンです。イベントには、メタデータのみが含まれる場合や、finishReason を含まない中間コンテンツが含まれる場合があります。ストリームは自然なEOFで終了し、[DONE] マーカーは付加されません。

パスパラメータ

modelstringpath必須

モデル名(例: gemini-2.5-pro, gemini-3.5-flash)。

クエリパラメータ

keystringquery

APIキー(ヘッダー認証の代わりに使用)。

認証

コンテンツの生成 と同様です:?key=、x-goog-api-key、または Authorization: Bearer を使用します。

リクエストボディ

コンテンツの生成 と同様です。これには、画像認識リクエスト用の構造化された inline_data 画像パーツを含むマルチモーダルな parts 配列が含まれます。

generationConfig.candidateCount、ツール、メディアタイプ、およびその他のオプションフィールドのサポートは、選択したモデルによって異なります。

レスポンス

Gemini Server-Sent Eventsを返します。メタデータのみのイベント、finishReason を含まない中間チャンク、および自然なEOFはすべて有効です。ストリームにはChat Completionsのような [DONE] 終了マーカーは付加されません。各イベントは、1つのJSONチャンクを保持する data: 行です。レスポンスは常にSSE形式です。alt=sse は受け入れられますが、必須ではありません。

最初のイベントより前にエラーが発生した場合は、コンテンツの生成 と同じコードを持つJSON形式のGeminiエラーが返されます。

リクエスト

curl -N -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:streamGenerateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Tell me a story"}]
      }
    ]
  }'

レスポンス

Stream Chunk
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Once upon a time"}
        ]
      }
    }
  ]
}

ビジョン入力の例

ストリーミングのビジョンリクエストでは、非ストリーミングエンドポイントと同じ contents[].parts[] 構造を使用します。

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this image." },
        {
          "inline_data": {
            "mime_type": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

認証

AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

パスパラメータ

model*string

モデル名 (例: gemini-2.5-pro)

クエリパラメータ

key?string

APIキー (ヘッダー認証の代替)

ヘッダー

X-TokenLab-Delivery-Policy?string

リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。自動的にまず TokenLab Verified を試行し、出力、リクエストの受け入れ、または永続的なリソース作成の前に、一度だけ Official に切り替える場合があります。

指定できる値

  • "auto"
  • "verified"
  • "official"

リクエストボディ

application/json

ネイティブGemini GenerateContentリクエスト。ProtoJSONのlowerCamelCaseと元のprotoのsnake_caseの両方が受け入れられ、保持されます(混在リクエストを含む)。1つのフィールドに対して両方の綴りが存在する場合、TokenLabはそれらをマージしたり、ローカルの優先順位を選択したりしません。不明なフィールドはベストエフォートで転送されます。

レスポンス

text/event-stream

application/json

application/json

application/json

application/json

application/json