Matriz de compatibilidade
Compatibilidade de ferramentas e SDKs
Encontre a configuração do TokenLab para ferramentas de programação, aplicativos de chat, SDKs e frameworks
A maioria das ferramentas se conecta ao TokenLab alterando a chave de API e a URL base. A configuração exata depende do formato de API que a ferramenta pode usar.
| Formato de API | URL base | Clientes comuns |
|---|---|---|
| Chat Completions (Compatível com OpenAI) | https://api.tokenlab.sh/v1 | SDKs da OpenAI, diversos aplicativos de chat e frameworks |
| OpenAI Responses | https://api.tokenlab.sh/v1 | Clientes de Responses e ferramentas que usam eventos de Responses |
| Anthropic Messages | https://api.tokenlab.sh | SDKs da Anthropic e ferramentas voltadas ao Claude |
| Gemini | https://api.tokenlab.sh | Clientes REST e SDKs do Gemini que permitem um host personalizado |
O modelo escolhido deve incluir o mesmo formato em accepted_request_formats. Streaming e chamadas de ferramentas também dependem dos recursos do modelo e do cliente. Veja exemplos em Formatos de API.
Indicadores de compatibilidade
| Indicador | Significado |
|---|---|
| Compatível | A configuração do TokenLab na página vinculada usa as opções documentadas do cliente |
| Compatível com limitações | A configuração se aplica a funções ou métodos de autenticação específicos; os demais serviços do fornecedor mantêm seus próprios requisitos |
Esses indicadores descrevem a configuração da página vinculada. Os recursos disponíveis também dependem do modelo escolhido e da versão do cliente.
Ferramentas de programação
| Ferramenta | Status | Formato de API | Observações |
|---|---|---|---|
| Claude Code | Compatível | Anthropic Messages | Usa ANTHROPIC_BASE_URL e uma chave de API do TokenLab |
| Codex CLI | Compatível com limitações | Responses | Usa Responses; os recursos disponíveis dependem do modelo escolhido |
| Cursor | Compatível com limitações | Compatível com OpenAI | Aplica-se aos recursos do Cursor que aceitam chave de API e URL personalizadas |
| Cline | Compatível | Compatível com OpenAI | Selecione OpenAI Compatible e informe a URL base e o ID do modelo |
| Kilo Code | Compatível | Compatível com OpenAI | Usa um provedor personalizado e um ID de modelo |
| OpenCode | Compatível | Compatível com OpenAI | Carregue uma configuração de provedor separada com OPENCODE_CONFIG |
| OpenHands | Compatível | Compatível com OpenAI | Interface baseada em LiteLLM: Advanced → Custom Model (prefixo openai/) e Base URL |
| Gemini CLI | Compatível com limitações | Gemini | Use GOOGLE_GEMINI_BASE_URL com autenticação por chave de API; um GEMINI_CLI_HOME separado preserva a configuração existente |
Aplicativos de chat
| Aplicativo | Status | Observações |
|---|---|---|
| Chatbox | Compatível | Adicione um provedor OpenAI API Compatible |
| Cherry Studio | Compatível | Adicione um provedor e conclua Verify and Enable |
| DeepChat | Compatível | Escolha OpenAI Completions para usar Chat Completions |
| Jan | Compatível | Adicione um serviço compatível com OpenAI |
| LibreChat | Compatível | Configure um endpoint personalizado compatível com OpenAI |
| Open WebUI | Compatível | Adicione uma conexão compatível com OpenAI com API Type em Chat |
SDKs e frameworks
| Cliente | Status | Configuração |
|---|---|---|
| SDK da OpenAI | Compatível | Defina base_url / baseURL como https://api.tokenlab.sh/v1 |
| SDK da Anthropic | Compatível | Defina a URL base como https://api.tokenlab.sh |
| Vercel AI SDK | Compatível | Crie um provedor personalizado compatível com OpenAI |
| LangChain | Compatível | Configure ChatOpenAI ou OpenAIEmbeddings com a URL do TokenLab |
| LlamaIndex | Compatível | Use as opções de cliente compatível com OpenAI |
| OpenAI Agents SDK | Compatível com limitações | O guia usa OpenAIChatCompletionsModel; verifique os recursos do modelo e do SDK antes de usar Responses |
| AutoGen | Compatível | Use um cliente de modelos compatível com OpenAI |
| CrewAI | Compatível | Configure o cliente LLM compatível com OpenAI |
| PydanticAI | Compatível | Forneça um provedor compatível com OpenAI |
Outros frameworks, ferramentas de observabilidade, gateways e produtos de avaliação estão na navegação de Integrations.
Consumo em respostas de streaming
Os fluxos de Chat Completions aceitam stream_options: { include_usage: true }, que adiciona um último bloco de consumo antes de encerrar o fluxo. A API Responses não oferece include_usage; seus fluxos informam o consumo no evento final.
O que uma chave de API personalizada não substitui
Alguns produtos combinam chamadas ao modelo com recursos hospedados pelo fornecedor. Uma chave do TokenLab pode atender às solicitações de modelo disponíveis nas configurações BYOK, mas não substitui outras assinaturas, serviços de preenchimento automático, funções de conta ou extensões proprietárias.
Se uma atualização alterar a configuração de uma ferramenta, consulte a página de integração atual em vez de copiar um exemplo antigo de variáveis de ambiente.
Antes de depender de um recurso
- Confirme que a ferramenta permite uma URL base personalizada para o formato necessário.
- Confirme que o modelo inclui esse formato em
accepted_request_formats. - Teste streaming e chamadas de ferramentas se seu fluxo de trabalho precisar deles.
- Guarde a chave de API em uma máquina ou servidor confiável.
- Registre o ID da solicitação ao relatar uma falha.