Gemini nativo

Gerar Conteúdo em Stream

Transmite a geração de conteúdo usando o formato da API Google Gemini

POST
/v1beta/models/{model}:streamGenerateContent

Versão SSE do generateContent do Gemini. Os eventos podem conter apenas metadados ou conteúdo intermediário sem finishReason. A stream termina no EOF natural e não adiciona um marcador [DONE].

Parâmetros de Path

modelstringpathobrigatório

Nome do modelo (ex.: gemini-2.5-pro, gemini-3.5-flash).

Parâmetros de Query

keystringquery

Chave de API (alternativa à autenticação via cabeçalho).

Autenticação

O mesmo que Gerar Conteúdo: ?key=, x-goog-api-key ou Authorization: Bearer.

Corpo da Requisição

O mesmo que Gerar Conteúdo. Isso inclui arrays multimodais de parts com partes de imagem inline_data estruturadas para requisições de visão.

O suporte para generationConfig.candidateCount, ferramentas, tipos de mídia e outros campos opcionais depende do modelo selecionado.

Resposta

Retorna Server-Sent Events do Gemini. Eventos contendo apenas metadados, chunks intermediários sem finishReason e EOF natural são válidos. A stream não adiciona a sentinela [DONE] de Chat Completions. Cada evento é uma linha data: que contém um chunk JSON. A resposta é sempre SSE; alt=sse é aceito, mas não obrigatório.

Um erro antes do primeiro evento retorna um erro JSON do Gemini com os mesmos códigos que Gerar Conteúdo.

Requisição

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

Resposta

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

Exemplo de Entrada de Visão

Requisições de visão em streaming usam a mesma estrutura contents[].parts[] do endpoint sem streaming.

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

Autorização

AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Parâmetros de caminho

model*string

Nome do modelo (ex: gemini-2.5-pro)

Parâmetros de consulta

key?string

Chave de API (alternativa à autenticação via cabeçalho)

Cabeçalhos

X-TokenLab-Delivery-Policy?string

Política de entrega por solicitação. Substitui os padrões da API key e do Workspace. Tenta automaticamente o TokenLab Verified primeiro e pode alternar uma vez para Official apenas antes da saída, aceitação da solicitação ou criação de recurso persistente.

Valores permitidos

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

Corpo da requisição

application/json

Solicitação nativa Gemini GenerateContent. Nomes em lowerCamelCase do ProtoJSON e nomes originais em snake_case do proto são aceitos e preservados, incluindo solicitações mistas. Se ambas as grafias de um campo estiverem presentes, o TokenLab não as mescla nem escolhe uma precedência local. Campos desconhecidos são encaminhados com base no melhor esforço.

Resposta

text/event-stream

application/json

application/json

application/json

application/json

application/json