Gemini ネイティブ
Stream Generate Content
Google Gemini API形式を使用したコンテンツ生成のストリーミング
Geminiの generateContent のSSEバージョンです。イベントには、メタデータのみが含まれる場合や、finishReason を含まない中間コンテンツが含まれる場合があります。ストリームは自然なEOFで終了し、[DONE] マーカーは付加されません。
パスパラメータ
モデル名(例: gemini-2.5-pro, gemini-3.5-flash)。
クエリパラメータ
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"}]
}
]
}'レスポンス
{
"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..."
}
}
]
}
]
}APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
パスパラメータ
モデル名 (例: gemini-2.5-pro)
クエリパラメータ
APIキー (ヘッダー認証の代替)
ヘッダー
リクエストごとの配信ポリシー。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