Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

A TokenLab suporta o formato nativo da API Google Gemini para modelos Gemini. Isso permite compatibilidade direta com os SDKs de IA do Google.

​
Parâmetros de Caminho

​
model
string
obrigatório
Nome do modelo (ex: gemini-2.5-pro, gemini-2.5-flash).Para integrações em produção, prefira partes de mídia fileData / file_data baseadas em URL com uma URL pública https. O TokenLab encaminhará canais nativos do Gemini com suporte pela rota nativa quando possível e fará fallback automaticamente para o caminho interno de conversão compatível quando uma rota pronta para uso nativo não estiver disponível para aquela solicitação multimodal.

​
Parâmetros de Consulta

​
key
string
Chave de API (alternativa à autenticação por cabeçalho).

​
Autenticação

Os endpoints do Gemini suportam múltiplos métodos de autenticação:
  • ?key=YOUR_API_KEY parâmetro de consulta
  • x-goog-api-key: YOUR_API_KEY cabeçalho
  • Authorization: Bearer YOUR_API_KEY cabeçalho

​
Corpo da Requisição

​
contents
array
obrigatório
Conteúdos da conversa.Cada objeto de conteúdo contém:
  • role (string): user ou model
  • parts (array): partes do conteúdo. A TokenLab atualmente suporta:
    • partes de texto: { "text": "..." }
    • partes de mídia inline: inlineData / inline_data
    • partes de arquivo baseadas em URL: fileData / file_data
Para partes de mídia, a TokenLab aceita atualmente MIME types de imagem, áudio e vídeo e os encaminha pelo contrato público compatível com Gemini.Os valores de role user e model são normalizados sem diferenciar maiúsculas. inlineData / inline_data com application/octet-stream só é aceito quando a TokenLab consegue identificar bytes de imagem ou vídeo compatíveis; caso contrário, a requisição falha antes do roteamento. Para requisições nativas com saída de imagem, apenas a família de ferramentas Google search/maps é aceita, e combinações não suportadas falham antes de novas tentativas upstream.
​
systemInstruction
object
Instrução de sistema para o modelo.
​
generationConfig
object
Configuração de geração:
  • temperature (number): Temperatura de amostragem
  • topP (number): Probabilidade de amostragem nucleus
  • topK (integer): Amostragem Top-K
  • maxOutputTokens (integer): Máximo de tokens de saída
  • stopSequences (array): Sequências de parada
​
safetySettings
array
Configurações de filtro de segurança.

​
Resposta

​
candidates
array
Candidatos de conteúdo gerado.
​
usageMetadata
object
Informações de uso de tokens.
curl -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Hello, Gemini!"}]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  }'

​
Exemplos de entrada multimodal

Para requisições multimodais do Gemini, coloque a mídia dentro de contents[].parts[] usando bytes inline ou referências de arquivo baseadas em URL. Categorias de mídia atualmente suportadas no contrato público do Gemini:
  • image
  • audio
  • video
Para mídia inline, use inlineData ou inline_data e envie os bytes do arquivo codificados em Base64. Para mídia via URL, use fileData ou file_data e envie uma URL pública em https.

​
Exemplo de entrada de imagem

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Descreva esta imagem." },
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

​
Exemplo de entrada de áudio

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Transcreva e resuma este áudio." },
        {
          "file_data": {
            "mime_type": "audio/mpeg",
            "file_uri": "https://example.com/sample.mp3"
          }
        }
      ]
    }
  ]
}

​
Exemplo de entrada de vídeo

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Descreva brevemente este vídeo." },
        {
          "fileData": {
            "mimeType": "video/mp4",
            "fileUri": "https://example.com/sample.mp4"
          }
        }
      ]
    }
  ]
}

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Hello! How can I assist you today?"}
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 10,
    "totalTokenCount": 15
  }
}

​
Exemplo de Entrada de Vídeo

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this video." },
        {
          "fileData": {
            "mimeType": "video/mp4",
            "fileUri": "https://example.com/demo.mp4"
          }
        }
      ]
    }
  ]
}

​
Exemplo de Entrada de Áudio

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this audio." },
        {
          "fileData": {
            "mimeType": "audio/mpeg",
            "fileUri": "https://example.com/demo.mp3"
          }
        }
      ]
    }
  ]
}