Gemini nativo
Gerar Conteúdo em Stream
Transmite a geração de conteúdo usando o formato da API Google Gemini
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
Nome do modelo (ex.: gemini-2.5-pro, gemini-3.5-flash).
Parâmetros de Query
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
{
"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..."
}
}
]
}
]
}Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Parâmetros de caminho
Nome do modelo (ex: gemini-2.5-pro)
Parâmetros de consulta
Chave de API (alternativa à autenticação via cabeçalho)
Cabeçalhos
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