Gerar Conteúdo

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

import google.generativeai as genai

genai.configure(
    api_key="sk-your-api-key",
    transport="rest",
    client_options={"api_endpoint": "api.tokenlab.sh"}
)

model = genai.GenerativeModel("gemini-2.5-pro")
response = model.generate_content("Hello, Gemini!")

print(response.text)

import { GoogleGenerativeAI } from "@google/generative-ai";

const genAI = new GoogleGenerativeAI("sk-your-api-key", {
  baseUrl: "https://api.tokenlab.sh"
});

const model = genAI.getGenerativeModel({ model: "gemini-2.5-pro" });
const result = await model.generateContent("Hello, Gemini!");

console.log(result.response.text());

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    payload := map[string]interface{}{
        "contents": []map[string]interface{}{
            {
                "parts": []map[string]string{
                    {"text": "Hello, Gemini!"},
                },
            },
        },
        "generationConfig": map[string]interface{}{
            "temperature":    0.7,
            "maxOutputTokens": 1024,
        },
    }

    jsonData, _ := json.Marshal(payload)
    req, _ := http.NewRequest("POST",
        "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key",
        bytes.NewBuffer(jsonData))
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

<?php
$payload = [
    'contents' => [
        [
            'parts' => [
                ['text' => 'Hello, Gemini!']
            ]
        ]
    ],
    'generationConfig' => [
        'temperature' => 0.7,
        'maxOutputTokens' => 1024
    ]
];

$ch = curl_init('https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode($payload)
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo $data['candidates'][0]['content']['parts'][0]['text'];

{
  "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
  }
}

O TokenLab expõe esta rota apenas para modelos que anunciam um contrato Gemini nativo e têm uma rota upstream do mesmo protocolo; não há fallback para Chat Completions. Nomes ProtoJSON em lowerCamelCase e nomes proto originais em snake_case são oficiais e preservados, inclusive em solicitações mistas. Campos desconhecidos são encaminhados em best-effort e o upstream decide o suporte.

Parâmetros de Caminho

string

obrigatório

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

Parâmetros de Consulta

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

array

obrigatório

Conteúdo da conversa. Valores de role e todos os parts são preservados como enviados; o TokenLab não faz trim/lowercase, reescrita de Base64 nem inferência de MIME. inlineData / inline_data e fileData / file_data são grafias oficiais, e o TokenLab não exige localmente fileData.mimeType. IDs de Files ou Cache criados pelo TokenLab têm a propriedade verificada e mantêm o vínculo upstream; o provedor decide as demais regras de mídia e ferramentas.

object

Instrução de sistema para o modelo.

object

Configuração nativa de geração. Nomes lowerCamelCase como maxOutputTokens, candidateCount e thinkingConfig, além dos equivalentes snake_case, são aceitos sem alteração. O TokenLab não remove thinkingConfig após falhas nem impõe limite local de candidateCount no streaming; o upstream decide intervalos e combinações.

array

Configurações de filtro de segurança.

Resposta

array

Candidatos de conteúdo gerado.

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

import google.generativeai as genai

genai.configure(
    api_key="sk-your-api-key",
    transport="rest",
    client_options={"api_endpoint": "api.tokenlab.sh"}
)

model = genai.GenerativeModel("gemini-2.5-pro")
response = model.generate_content("Hello, Gemini!")

print(response.text)

import { GoogleGenerativeAI } from "@google/generative-ai";

const genAI = new GoogleGenerativeAI("sk-your-api-key", {
  baseUrl: "https://api.tokenlab.sh"
});

const model = genAI.getGenerativeModel({ model: "gemini-2.5-pro" });
const result = await model.generateContent("Hello, Gemini!");

console.log(result.response.text());

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    payload := map[string]interface{}{
        "contents": []map[string]interface{}{
            {
                "parts": []map[string]string{
                    {"text": "Hello, Gemini!"},
                },
            },
        },
        "generationConfig": map[string]interface{}{
            "temperature":    0.7,
            "maxOutputTokens": 1024,
        },
    }

    jsonData, _ := json.Marshal(payload)
    req, _ := http.NewRequest("POST",
        "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key",
        bytes.NewBuffer(jsonData))
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

<?php
$payload = [
    'contents' => [
        [
            'parts' => [
                ['text' => 'Hello, Gemini!']
            ]
        ]
    ],
    'generationConfig' => [
        'temperature' => 0.7,
        'maxOutputTokens' => 1024
    ]
];

$ch = curl_init('https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode($payload)
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo $data['candidates'][0]['content']['parts'][0]['text'];

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 nos detalhes do modelo 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"
          }
        }
      ]
    }
  ]
}

Essencial

Texto

Arquivos e lotes

Imagens

Áudio e tempo real

Música

Vídeo e materiais

Worlds

3D

Tarefas assíncronas

Gemini nativo

Gerenciamento

Parâmetros de Caminho

Parâmetros de Consulta

Autenticação

Corpo da Requisição

Resposta

Exemplos de entrada multimodal

Exemplo de entrada de imagem

Exemplo de entrada de áudio

Exemplo de entrada de vídeo

Exemplo de Entrada de Vídeo

Exemplo de Entrada de Áudio

​Parâmetros de Caminho

​Parâmetros de Consulta

​Autenticação

​Corpo da Requisição

​Resposta

​Exemplos de entrada multimodal

​Exemplo de entrada de imagem

​Exemplo de entrada de áudio

​Exemplo de entrada de vídeo

​Exemplo de Entrada de Vídeo

​Exemplo de Entrada de Áudio

Parâmetros de Caminho

Parâmetros de Consulta

Autenticação

Corpo da Requisição

Resposta

Exemplos de entrada multimodal

Exemplo de entrada de imagem

Exemplo de entrada de áudio

Exemplo de entrada de vídeo

Exemplo de Entrada de Vídeo

Exemplo de Entrada de Áudio