Guias principais

Guias de Migração

Migre clientes existentes de OpenAI, Anthropic, Gemini e de mídia para o TokenLab

Mantenha o formato de solicitação que sua aplicação já utiliza. Clientes compatíveis com OpenAI, Anthropic Messages, Gemini REST e endpoints de mídia possuem um endereço de API TokenLab correspondente.

Mapeamento de API

API ExistenteURL base do TokenLabEndpointTenha em mente
OpenAI Chat Completionshttps://api.tokenlab.sh/v1/chat/completionsMenor alteração para chat e chamadas de função compatíveis com OpenAI
OpenAI Responseshttps://api.tokenlab.sh/v1/responsesUse quando sua aplicação depender de entradas, ferramentas ou tratamento de saída específicos de Responses
Anthropic SDKhttps://api.tokenlab.sh/v1/messagesNão adicione /v1 à URL base do SDK
Gemini RESThttps://api.tokenlab.sh/v1beta/models/:model:generateContentMantenha os campos nativos do Gemini na rota do Gemini
Geração de mídiahttps://api.tokenlab.sh/v1/images/generations, /videos/generations, /music/generations, /3d/generationsDescubra modelos com recommended_for e espere polling assíncrono onde documentado
Gerenciamento e faturamentohttps://api.tokenlab.sh/v1/management/...Chamadas do lado do servidor usam um token de gerenciamento, não uma chave de API de modelo

Receitas Rápidas de Migração

OpenAI para TokenLab

Altere o base_url / baseURL do SDK para https://api.tokenlab.sh/v1, substitua a chave de API e escolha um ID de modelo em GET /v1/models.

OpenRouter para TokenLab

Substitua a URL base do OpenRouter por https://api.tokenlab.sh/v1. Os IDs de modelo do TokenLab não incluem um prefixo de provedor do OpenRouter. Use Anthropic Messages ou Gemini apenas quando sua aplicação precisar de campos desses formatos.

LiteLLM para TokenLab

Use a configuração custom_openai/<model> do LiteLLM com api_base: https://api.tokenlab.sh/v1. Mantenha seu alias do LiteLLM separado do ID de modelo do TokenLab para que qualquer um deles possa ser alterado sem editar os prompts da aplicação.

Claude Messages via TokenLab

Aponte os clientes do SDK da Anthropic para https://api.tokenlab.sh e chame messages.create. Não adicione /v1 à URL base do SDK; o SDK já possui o caminho /v1/messages.

Gemini Native via TokenLab

Mantenha os payloads do Gemini em https://api.tokenlab.sh/v1beta/models/{model}:generateContent. contents, parts, arquivos, conteúdos em cache, declarações de função e ferramentas integradas nativas do Gemini devem permanecer nesta rota quando sua aplicação depender do comportamento do Gemini.

Migração Compatível com OpenAI

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-tokenlab-key",
    base_url="https://api.tokenlab.sh/v1",
)

response = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[{"role": "user", "content": "Hello from TokenLab"}],
)

Seu código existente de retry, timeout e streaming geralmente pode ser mantido. Confirme o ID do modelo com GET /v1/models. Solicitações de imagem devem incluir um modelo explicitamente; consulte o guia de imagem para entradas específicas do modelo.

Migração Anthropic

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-tokenlab-key",
    base_url="https://api.tokenlab.sh",
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Reply with: Connected to TokenLab."}],
)

Use /v1/messages para chamadas de ferramenta do Claude, blocos de pensamento (thinking blocks) e campos de mensagem da Anthropic. O Chat Completions não garante esses campos.

Migração Gemini

curl "https://api.tokenlab.sh/v1beta/models/gemini-3.6-flash:generateContent" \
  -H "Authorization: Bearer sk-your-tokenlab-key" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Hello"}]}]}'

Mantenha ferramentas integradas do Gemini, referências da File API, conteúdos em cache, declarações de função e partes de conteúdo nativas em /v1beta quando sua aplicação depender do comportamento nativo do Gemini.

Migração de Mídia

  1. Consulte GET /v1/models?recommended_for=image|video|music|3d.
  2. Leia a lista de modelos em GET /v1/models e os detalhes completos em GET /v1/models/{model}.
  3. Envie um model explícito, especialmente para endpoints de imagem.
  4. Armazene task_id, poll_url, endpoint, modelo e seu próprio ID de trabalho para tarefas assíncronas. Faça o polling deles com GET /v1/tasks/{id}.
  5. Concilie os custos através de registros de uso e billing_transaction_id, não IDs de tarefa do provedor.

A geração de mídia pode ser concluída de forma assíncrona, portanto, salve task_id e poll_url antes de substituir uma integração existente. Um timeout na solicitação de criação não deve produzir um segundo trabalho para o usuário.

Armadilhas da Migração

  • Não coloque todos os modelos atrás de um único caminho de OpenAI Chat Completions se sua aplicação precisar de comportamento nativo da Anthropic, Gemini ou Responses.
  • Não presuma padrões antigos de imagem. Envie o model explicitamente.
  • Não tente novamente solicitações de criação assíncronas sem verificar se uma tarefa já foi criada.
  • Use IDs de tarefa e registros de uso do TokenLab em seu produto. IDs de tarefa de terceiros não são identificadores de faturamento.

Referência de API

TópicoReferência
API Multi-FormatoAPI Multi-Formato
SDK OpenAISDK OpenAI
SDK AnthropicSDK Anthropic
Gemini NativeAPI Gemini Native
Geração de ImagemGeração de Imagem
Trabalhos Assíncronos e PollingTrabalhos Assíncronos e Polling

Nesta página