Matriz de compatibilidade
Compatibilidade de ferramentas e SDK
Encontre a configuração correta do TokenLab para ferramentas de codificação, aplicativos de chat, SDKs e frameworks
A maioria das ferramentas se conecta ao TokenLab alterando uma chave de API e a URL base. A configuração exata depende de qual formato de API a ferramenta pode utilizar.
| Formato de API | URL Base | Clientes comuns |
|---|---|---|
| Chat Completions (compatível com OpenAI) | https://api.tokenlab.sh/v1 | SDKs da OpenAI, muitos aplicativos de chat e frameworks |
| OpenAI Responses | https://api.tokenlab.sh/v1 | Clientes Responses e ferramentas criadas em torno de eventos Responses |
| Anthropic Messages | https://api.tokenlab.sh | SDKs da Anthropic e ferramentas orientadas ao Claude |
| Gemini | https://api.tokenlab.sh | Clientes REST e SDK do Gemini que permitem um host personalizado |
O modelo selecionado deve listar o mesmo formato em accepted_request_formats. O streaming e a chamada de ferramentas (tool calling) também dependem dos recursos do modelo e do cliente. Veja formatos de API para exemplos.
Rótulos de compatibilidade
| Rótulo | Significado |
|---|---|
| Funciona | A configuração do TokenLab vinculada utiliza as opções de configuração documentadas do cliente |
| Funciona com limitações | A configuração se aplica a recursos específicos ou modos de autenticação; outros serviços de fornecedores mantêm seus próprios requisitos |
Estes rótulos descrevem a configuração na página vinculada. A disponibilidade de recursos também depende do modelo selecionado e da versão do cliente.
Ferramentas de codificação
| Ferramenta | Status | Formato de API | Notas |
|---|---|---|---|
| Claude Code | Funciona | Anthropic Messages | Usa ANTHROPIC_BASE_URL e uma chave de API do TokenLab |
| Codex CLI | Funciona com limitações | Responses | Usa Responses; os recursos disponíveis dependem do modelo selecionado |
| Cursor | Funciona com limitações | Compatível com OpenAI | Aplica-se aos recursos do Cursor que aceitam uma chave de API e URL personalizadas |
| Cline | Funciona | Compatível com OpenAI | Selecione OpenAI Compatible e insira uma URL base e ID do modelo |
| Kilo Code | Funciona | Compatível com OpenAI | Usa um provedor personalizado e ID do modelo |
| OpenCode | Funciona | Compatível com OpenAI | Carregue uma configuração de provedor separada com OPENCODE_CONFIG |
| OpenHands | Funciona | Compatível com OpenAI | Interface baseada em LiteLLM: Advanced → Custom Model (prefixo openai/) e Base URL |
| Gemini CLI | Funciona 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 |
| Visual Studio Code | Funciona com limitações | Compatível com OpenAI | Chat via Custom Endpoint (Chat Completions); não é necessário plano Copilot para chat. Sugestões inline e busca semântica ainda precisam do GitHub |
Aplicativos de chat
| Aplicativo | Status | Notas |
|---|---|---|
| Chatbox | Funciona | Adicione um provedor OpenAI API Compatible |
| Cherry Studio | Funciona | Adicione um provedor e conclua Verify and Enable |
| DeepChat | Funciona | Escolha OpenAI Completions para Chat Completions |
| Jan | Funciona | Adicione um serviço compatível com OpenAI |
| LibreChat | Funciona | Configure um endpoint personalizado compatível com OpenAI |
| Open WebUI | Funciona | Adicione uma conexão compatível com OpenAI com API Type Chat |
SDKs e frameworks
| Cliente | Status | Configuração |
|---|---|---|
| SDK da OpenAI | Funciona | Defina base_url / baseURL para https://api.tokenlab.sh/v1 |
| SDK da Anthropic | Funciona | Defina a URL base para https://api.tokenlab.sh |
| Vercel AI SDK | Funciona | Crie um provedor personalizado compatível com OpenAI |
| LangChain | Funciona | Configure ChatOpenAI ou OpenAIEmbeddings com a URL do TokenLab |
| LlamaIndex | Funciona | Use suas opções de cliente compatíveis com OpenAI |
| SDK de Agentes da OpenAI | Funciona com limitações | O guia usa OpenAIChatCompletionsModel; verifique o suporte a recursos do modelo e do SDK antes de usar Responses |
| AutoGen | Funciona | Use um cliente de modelo compatível com OpenAI |
| CrewAI | Funciona | Configure seu cliente LLM compatível com OpenAI |
| PydanticAI | Funciona | Forneça um provedor compatível com OpenAI |
Mais frameworks, ferramentas de observabilidade, gateways e produtos de avaliação estão listados na navegação de Integrações.
Uso em respostas via streaming
Os streams de Chat Completions aceitam stream_options: { include_usage: true }, que anexa um bloco de uso final antes do fechamento do stream. A API Responses não expõe include_usage; os streams de Responses relatam o uso em seu evento terminal.
O que uma chave de API personalizada não substitui
Alguns produtos misturam chamadas de modelo com recursos hospedados pelo fornecedor do produto. Uma chave do TokenLab pode alimentar as solicitações de modelo expostas através das configurações BYOK, mas não substitui assinaturas não relacionadas, serviços de preenchimento automático, recursos de conta ou extensões proprietárias.
Quando uma atualização de ferramenta alterar sua configuração, use a página de integração atual em vez de copiar um trecho de variável de ambiente antigo de outro lugar.
Antes de depender de um recurso
- Confirme se a ferramenta permite uma URL base personalizada para o formato que você precisa.
- Confirme se o modelo lista esse formato em
accepted_request_formats. - Teste o streaming e as chamadas de ferramentas se o seu fluxo de trabalho os exigir.
- Mantenha a chave de API em uma máquina ou servidor confiável.
- Registre o ID da solicitação (Request ID) ao relatar uma falha.