Gemini natif
Stream Generate Content
Diffuse le contenu généré en utilisant le format de l'API Google Gemini
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
Nom du modèle (par ex. gemini-2.5-pro, gemini-3.5-flash).
Paramètres de requête
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
{
"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..."
}
}
]
}
]
}Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
Paramètres de chemin
Nom du modèle (par ex., gemini-2.5-pro)
Paramètres de requête
Clé API (alternative à l'authentification par en-tête)
En-têtes
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