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 Existente | URL base do TokenLab | Endpoint | Tenha em mente |
|---|---|---|---|
| OpenAI Chat Completions | https://api.tokenlab.sh/v1 | /chat/completions | Menor alteração para chat e chamadas de função compatíveis com OpenAI |
| OpenAI Responses | https://api.tokenlab.sh/v1 | /responses | Use quando sua aplicação depender de entradas, ferramentas ou tratamento de saída específicos de Responses |
| Anthropic SDK | https://api.tokenlab.sh | /v1/messages | Não adicione /v1 à URL base do SDK |
| Gemini REST | https://api.tokenlab.sh | /v1beta/models/:model:generateContent | Mantenha os campos nativos do Gemini na rota do Gemini |
| Geração de mídia | https://api.tokenlab.sh/v1 | /images/generations, /videos/generations, /music/generations, /3d/generations | Descubra modelos com recommended_for e espere polling assíncrono onde documentado |
| Gerenciamento e faturamento | https://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
- Consulte
GET /v1/models?recommended_for=image|video|music|3d. - Leia a lista de modelos em
GET /v1/modelse os detalhes completos emGET /v1/models/{model}. - Envie um
modelexplícito, especialmente para endpoints de imagem. - Armazene
task_id,poll_url, endpoint, modelo e seu próprio ID de trabalho para tarefas assíncronas. Faça o polling deles comGET /v1/tasks/{id}. - 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
modelexplicitamente. - 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ópico | Referência |
|---|---|
| API Multi-Formato | API Multi-Formato |
| SDK OpenAI | SDK OpenAI |
| SDK Anthropic | SDK Anthropic |
| Gemini Native | API Gemini Native |
| Geração de Imagem | Geração de Imagem |
| Trabalhos Assíncronos e Polling | Trabalhos Assíncronos e Polling |