TokenLab

Gemini natif

Stream Generate Content

Diffuse le contenu généré en utilisant le format de l'API Google Gemini

POST
/v1beta/models/{model}:streamGenerateContent

Version SSE de generateContent de Gemini. Les événements peuvent contenir uniquement des métadonnées ou du contenu intermédiaire sans finishReason. Le flux se termine à la fin naturelle du fichier (EOF) et n'ajoute pas de marqueur [DONE].

Paramètres de chemin

modelstringpathrequis

Nom du modèle (par ex. gemini-2.5-pro, gemini-3.5-flash).

Paramètres de requête

keystringquery

Clé API (alternative à l'authentification par en-tête).

Authentification

Identique à Générer du contenu : ?key=, x-goog-api-key, ou Authorization: Bearer.

Corps de la requête

Identique à Générer du contenu. Cela inclut les tableaux parts multimodaux avec des parties d'image inline_data structurées pour les requêtes de vision.

La prise en charge de generationConfig.candidateCount, des outils, des types de médias et d'autres champs optionnels dépend du modèle sélectionné.

Réponse

Renvoie des Server-Sent Events (SSE) Gemini. Les événements contenant uniquement des métadonnées, les fragments intermédiaires sans finishReason et la fin naturelle du flux (EOF) sont valides. Le flux n'ajoute pas le marqueur [DONE] des Chat Completions. Chaque événement est une ligne data: qui contient un fragment JSON. La réponse est toujours en SSE ; alt=sse est accepté mais n'est pas requis.

Une erreur survenant avant le premier événement renvoie une erreur JSON Gemini avec les mêmes codes que Générer du contenu.

Requête

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"}]
      }
    ]
  }'

Réponse

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

Exemple d'entrée Vision

Les requêtes de vision en streaming utilisent la même structure contents[].parts[] que le point de terminaison sans streaming.

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

Autorisation

AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

Paramètres de chemin

model*string

Nom du modèle (par ex., gemini-2.5-pro)

Paramètres de requête

key?string

Clé API (alternative à l'authentification par en-tête)

En-têtes

X-TokenLab-Delivery-Policy?string

Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.

Valeurs possibles

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

Corps de la requête

application/json

Requête native Gemini GenerateContent. Les noms ProtoJSON lowerCamelCase et proto snake_case originaux sont tous deux acceptés et préservés, y compris les requêtes mixtes. Si les deux orthographes d'un champ sont présentes, TokenLab ne les fusionne pas et ne choisit pas de priorité locale. Les champs inconnus sont transmis au mieux.

Réponse

text/event-stream

application/json

application/json

application/json

application/json

application/json