Gemini nativo

Generar contenido en streaming

Transmite la generación de contenido utilizando el formato de la API de Google Gemini

POST
/v1beta/models/{model}:streamGenerateContent

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

modelstringpathobligatorio

Nombre del modelo (por ejemplo, gemini-2.5-pro, gemini-3.5-flash).

Parámetros de consulta

keystringquery

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

Stream Chunk
{
  "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..."
          }
        }
      ]
    }
  ]
}

Autorización

AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Parámetros de ruta

model*string

Nombre del modelo (ej. gemini-2.5-pro)

Parámetros de consulta

key?string

Clave de API (alternativa a la autenticación por encabezado)

Encabezados

X-TokenLab-Delivery-Policy?string

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