Gemini nativo
Generar contenido en streaming
Transmite la generación de contenido utilizando el formato de la API de Google Gemini
Versión SSE de generateContent de Gemini. Los eventos pueden contener únicamente metadatos o contenido intermedio sin finishReason. La transmisión termina en el EOF natural y no añade un marcador [DONE].
Parámetros de ruta
Nombre del modelo (por ejemplo, gemini-2.5-pro, gemini-3.5-flash).
Parámetros de consulta
API key (alternativa a la autenticación mediante encabezado).
Autenticación
Igual que en Generar contenido: ?key=, x-goog-api-key o Authorization: Bearer.
Cuerpo de la solicitud
Igual que en Generar contenido. Esto incluye arrays de parts multimodales con partes de imagen inline_data estructuradas para solicitudes de visión.
La compatibilidad con generationConfig.candidateCount, herramientas, tipos de medios y otros campos opcionales depende del modelo seleccionado.
Respuesta
Devuelve Server-Sent Events de Gemini. Los eventos que solo contienen metadatos, los fragmentos intermedios sin finishReason y el EOF natural son válidos. La transmisión no añade el centinela [DONE] de Chat Completions. Cada evento es una línea data: que contiene un fragmento JSON. La respuesta siempre es SSE; se acepta alt=sse, pero no es obligatorio.
Un error antes del primer evento devuelve un error JSON de Gemini con los mismos códigos que Generar contenido.
Solicitud
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"}]
}
]
}'Respuesta
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{"text": "Once upon a time"}
]
}
}
]
}Ejemplo de entrada de visión
Las solicitudes de visión en streaming utilizan la misma estructura contents[].parts[] que el endpoint sin streaming.
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Please describe this image." },
{
"inline_data": {
"mime_type": "image/jpeg",
"data": "/9j/4AAQSkZJRgABAQ..."
}
}
]
}
]
}Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de ruta
Nombre del modelo (ej. gemini-2.5-pro)
Parámetros de consulta
Clave de API (alternativa a la autenticación por encabezado)
Encabezados
Política de entrega por solicitud. Sustituye los valores predeterminados de la API key y del Workspace. Auto intenta primero con TokenLab Verified y puede cambiar una vez a Official solo antes de la salida, la aceptación de la solicitud o la creación de recursos persistentes.
Valores permitidos
- "auto"
- "verified"
- "official"
Cuerpo de la solicitud
application/json
Solicitud nativa de Gemini GenerateContent. Se aceptan y conservan tanto los nombres lowerCamelCase de ProtoJSON como los nombres snake_case del proto original, incluyendo solicitudes mixtas. Si ambas grafías de un campo están presentes, TokenLab no las fusiona ni elige una precedencia local. Los campos desconocidos se reenvían bajo un criterio de mejor esfuerzo.
Respuesta
text/event-stream
application/json
application/json
application/json
application/json
application/json