Gemini Stream Generate Content

Recevez les résultats de génération en streaming SSE avec Gemini Stream Generate Content.

L’API Stream Generate Content utilise les mêmes Content, Parts, authentification Bearer et configuration que la génération ordinaire. Elle renvoie en continu des blocs GenerateContentResponse via SSE unidirectionnel ; elle se distingue de la Live API bidirectionnelle basée sur WebSocket.

Le client doit analyser chaque SSE data: selon les limites marquées par des lignes vides, puis concaténer les fragments textuels ou de Structured Output dans l’ordre. N’appliquez pas JSON.parse à l’ensemble du flux en une fois. Les blocs intermédiaires peuvent ne pas inclure finishReason ; conservez la dernière valeur de usageMetadata lorsqu’elle apparaît. Un même responseId relie tous les blocs d’une génération ; si candidates est absent, vérifiez promptFeedback.

POST/v1beta/models/{model}:streamGenerateContent

Renvoie des blocs GenerateContentResponse en continu via SSE.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez Bearer your-api-key dans le Header Authorization.

Emplacement: header

Paramètres de chemin

model*string

Identifiant du modèle de génération. Le chemin est automatiquement construit sous la forme models/{model}.

Valeur par défaut"MODEL_ID"

Paramètres de requête URL

alt*"sse"

Sélectionne le transport SSE. Ce paramètre appartient à la chaîne de requête de l’URL, et non au corps GenerateContentRequest.

Valeur par défaut"sse"

Valeurs autorisées

"sse"

Corps de requête

Gemini représente le texte, les entrées multimodales, les outils et la configuration de génération avec Content et Parts.

application/json

Conversation textuelle

Organisez une conversation textuelle à un ou plusieurs tours avec des Content user et model.

contents[]: Contenu de la conversation dans l’ordre.
parts[].text: Texte de chaque message.
role: Auteur du message, généralement user ou model.

application/json

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Bonjour ! Présentez-vous."
        }
      ]
    }
  ]
}

Utilisez Content et les Part text pour une conversation textuelle à un ou plusieurs tours.

contents*array<>

Content textuels dans l’ordre. Chaque message fournit son contenu via parts[].text.

Éléments1 <= items

tools?array<>

Fonctions, exécution de code, recherche, URL Context, File Search, MCP et autres outils utilisables par le modèle.

toolConfig?

Configuration des appels d’outils de la requête.

safetySettings?array<>

Seuils de blocage du contenu par catégorie de sécurité.

systemInstruction?

Instructions système définies par le développeur ; seul le texte est actuellement pris en charge.

generationConfig?

Configuration de génération et de sortie du modèle.

cachedContent?string

Nom du contenu mis en cache utilisé comme contexte, au format cachedContents/{cachedContent}.

serviceTier?ServiceTier

Niveau de service utilisé pour la requête.

Valeurs autorisées

"unspecified"
"standard"
"flex"
"priority"

store?boolean

Contrôle la journalisation de cette requête et, si défini, prévaut sur la configuration du projet.

Corps de réponse

`text/event-stream`

`application/json`

candidates?array<>

Réponses candidates générées par le modèle.

promptFeedback?

usageMetadata?

modelVersion?string

Version du modèle utilisée pour générer la réponse.

responseId?string

Identifiant de cette réponse.

modelStatus?

État du cycle de vie du modèle sous-jacent utilisé pour cette réponse.

curl -X POST "https://example.com/v1beta/models/MODEL_ID:streamGenerateContent?alt=sse" \  -H "Content-Type: application/json" \  -d '{    "contents": [      {        "role": "user",        "parts": [          {            "text": "Présentez l’informatique quantique étape par étape."          }        ]      }    ]  }' \  --no-buffer

Concaténez les fragments de texte dans l’ordre ; un même responseId indique qu’ils appartiennent à une même génération.

data: {"candidates":[{"content":{"parts":[{"text":"L’informatique quantique"}],"role":"model"},"index":0}],"modelVersion":"MODEL_ID","responseId":"response-stream-example"}

data: {"candidates":[{"content":{"parts":[{"text":" utilise des qubits pour traiter l’information."}],"role":"model"},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":8,"candidatesTokenCount":18,"totalTokenCount":26},"modelVersion":"MODEL_ID","responseId":"response-stream-example"}

Documentation officielle Google Gemini Stream Generate ContentConsultez la définition du protocole de streaming du fournisseur et les dernières modifications des champs.

Gemini Stream Generate Content

Authentification

Paramètres de chemin

Paramètres de requête URL

Corps de requête

Corps de réponse

200text/event-stream

400application/json

401application/json

403application/json

404application/json

413application/json

429application/json

500application/json

503application/json

504application/json

`text/event-stream`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`