Se você ainda mantém instalações do Roo Code, a rota Roo Code OpenAI compatible API é, em grande parte, uma superfície de configuração: tipo de provedor, Base URL, API key e Model ID. O risco em produção é a parte que é fácil de passar despercebida. A documentação do provedor do Roo Code exige chamadas nativas de ferramentas no estilo OpenAI para esse caminho, então uma resposta simples de chat não é prova suficiente para um fluxo de trabalho de agente de código.
Este guia mostra como rotear configurações existentes do Roo Code por meio do Flatkey para desenvolvedores, equipes de produto de IA, construtores de automação, engenheiros de plataforma, operadores financeiros e revisores de compras. Ele cobre a ressalva atual do Roo Code, a validação da Base URL do Flatkey, aliases de modelo exatos, pré-verificação nativa de tool call, configurações do Roo Code, revisão de uso e rollback.
Nota da fonte: isto foi verificado em 29 de junho de 2026 em relação à página inicial oficial da documentação do Roo Code, à documentação oficial do provedor Roo Code OpenAI Compatible, às páginas públicas ao vivo do Flatkey e a um teste smoke autenticado do gateway Flatkey. A página inicial da documentação do Roo Code informa que a extensão Roo Code foi descontinuada em 15 de maio de 2026; portanto, trate isto como um guia de configuração para instalações existentes, configurações arquivadas ou revisão de migração, e não como uma recomendação para padronizar uma nova implantação sem verificar a disponibilidade da extensão.
Resposta rápida: configuração da Roo Code OpenAI compatible API
Para uma configuração Roo Code OpenAI compatible API com o Flatkey, escolha OpenAI Compatible como provedor de API, cole uma Base URL atual do Flatkey, use uma API key do Flatkey e insira um alias exato de modelo do Flatkey que ofereça suporte a chat compatível com OpenAI e chamadas nativas de ferramentas. Depois, prove a rota com uma pequena solicitação curl antes de confiar nela dentro de um workspace de código.
| Campo do Roo Code | Valor do Flatkey | Verificação de revisão |
|---|---|---|
| API Provider | OpenAI Compatible | Use este provedor para o Flatkey, não o provedor oficial da OpenAI. |
| Base URL | A Base URL atual do provedor Flatkey para a sua conta, como https://router.flatkey.ai/v1 quando esse for o valor verificado |
Cole apenas a Base URL. Não cole o endpoint completo /chat/completions no Roo Code. |
| API Key | Uma key do Flatkey de propriedade do usuário, equipe ou ambiente corretos | Não misture chaves do provedor upstream com a Base URL do Flatkey. |
| Model ID | O alias exato de modelo do Flatkey habilitado para essa key | Confirme que o alias oferece suporte ao endpoint de chat da OpenAI e a chamadas nativas de ferramentas antes de usá-lo em tarefas de código. |
| Validation | Pequeno teste smoke de chat e de tool call, depois um prompt seguro no Roo Code | Verifique o uso no Flatkey após o teste para que as áreas financeira e de plataforma possam reconciliar a rota. |
O caminho mais curto e seguro é: provar o transporte do Flatkey, provar o alias do modelo, provar as chamadas nativas de ferramentas e, então, salvar as configurações do Roo Code. O restante deste guia Roo Code OpenAI compatible API transforma isso em uma lista de verificação repetível.
O que a documentação atual do Roo Code confirma
A página inicial da documentação do Roo Code atualmente exibe um aviso de descontinuação da extensão. Isso importa para o planejamento. Se a sua equipe estiver usando uma instalação existente do Roo Code, os detalhes de configuração abaixo ainda são úteis para manutenção e revisão de migração. Se a sua equipe estiver escolhendo um novo assistente de codificação padrão, primeiro verifique o status da extensão, do marketplace e do fork antes de atribuir o Roo Code a um grupo maior.
A página do provedor Roo Code OpenAI Compatible documenta três valores principais para essa classe de provedor: Base URL, API Key e Model ID. Ela também informa para selecionar OpenAI Compatible como provedor de API. A Base URL é o endpoint do provedor e explicitamente não é a URL oficial da API da OpenAI quando você está usando um provedor não compatível com OpenAI.
A restrição importante específica do Roo é a chamada de ferramentas. A mesma página do provedor afirma que o Roo Code usa exclusivamente chamadas nativas de ferramentas e não possui fallback baseado em XML. Também diz que o modelo selecionado deve oferecer suporte a chamadas de ferramentas compatíveis com OpenAI. Para uma rota Roo Code OpenAI compatible API por meio do Flatkey, isso significa que o alias do modelo não pode ser validado apenas com geração de texto simples.
Valores do Flatkey a confirmar antes de abrir o Roo Code
1. Confirme a Base URL da sua conta
A página inicial do Flatkey verificada em 29 de junho de 2026 tem o título One API gateway for production AI teams e uma meta description dizendo que o Flatkey unifica acesso a modelos, roteamento, faturamento, analytics de uso e controles operacionais. Exemplos públicos da página inicial incluem chat completions no estilo OpenAI. Uma verificação autenticada em tempo de execução para este artigo usou https://router.flatkey.ai/v1 e retornou uma lista válida de modelos.
Como exemplos públicos e rotas específicas de conta podem diferir ao longo do tempo, copie a Base URL atual do Flatkey do seu console, da documentação ou do ambiente em uso antes da produção. No Roo Code, a Base URL deve ser a base do provedor, e não /v1/chat/completions.
2. Confirme o alias do modelo e o suporte a ferramentas
A página de preços da Flatkey, verificada em 29 de junho de 2026, diz que publica preços renderizados no servidor para 635 modelos de IA em 23 provedores. O mapa de endpoints inclui /v1/chat/completions, /v1/responses, /v1/messages, /v1/images/generations e /v1/video/generations. Isso é evidência do catálogo e dos endpoints, não uma promessa de que toda chave da Flatkey pode chamar todo modelo.
Para uma configuração de Roo Code OpenAI compatible API, escolha um alias de modelo visível na conta que suporte chat compatível com OpenAI e chamadas de ferramentas. A verificação autenticada para este artigo retornou 56 modelos visíveis na conta, e uma pequena solicitação de chamada de ferramenta com gpt-5.4-mini retornou HTTP 200 com finish_reason: tool_calls e metadados de uso. Trate isso como prova datada da rota para a conta testada, não como uma recomendação permanente para todo workspace da Flatkey.
3. Confirme a propriedade da chave e a revisão de uso
O Roo Code pode agir em um workspace de código, então a propriedade da chave importa. Use uma chave da Flatkey limitada ao desenvolvedor, equipe ou ambiente que assume o risco. Registre quem pode rotacionar a chave, qual alias de modelo é permitido, qual família de endpoint é esperada e onde o registro de uso será revisado após o primeiro prompt.
Passo a passo: configurar o Roo Code com a Flatkey
- Verifique se esta é uma instalação existente do Roo Code. Como a documentação oficial atualmente menciona o encerramento da extensão, não comece assumindo que uma instalação nova da marketplace esteja disponível.
- Abra as configurações do provedor no Roo Code. Na configuração existente da extensão, vá para a área de provedor de modelo ou de configuração de API.
- Selecione OpenAI Compatible. Use o tipo de provedor documentado pelo Roo Code para endpoints compatíveis com OpenAI que não sejam da OpenAI.
- Defina a Base URL. Insira a base URL verificada da Flatkey, por exemplo
https://router.flatkey.ai/v1quando esse for o valor de trabalho atual para sua conta. - Cole a chave de API da Flatkey. Mantenha-a fora de arquivos do repositório, comentários de issues, capturas de tela e prompts.
- Defina o Model ID. Insira o alias exato do modelo da Flatkey. Não use um nome genérico da família do fornecedor, a menos que a Flatkey exponha esse alias exato para sua chave.
- Execute o preflight curl abaixo. Chat simples é útil, mas o Roo Code exige chamada nativa de ferramentas, então inclua um esquema de ferramenta no teste.
- Execute um prompt seguro no Roo Code. Use um workspace descartável ou uma tarefa não destrutiva antes de apontar o Roo Code para repositórios de produção.
- Verifique o uso na Flatkey. Confirme timestamp, proprietário da chave, alias do modelo, uso de tokens, status e visibilidade de custo.
- Documente a reversão. Salve as configurações anteriores do provedor, o alias do modelo e o proprietário antes de pedir que mais desenvolvedores façam a troca.
Modelo de preflight para chamada nativa de ferramentas
A forma mais segura de depurar uma configuração de Roo Code OpenAI compatible API é testar primeiro a rota da Flatkey fora do Roo Code. Este modelo verifica o endpoint de chat e pede ao modelo que retorne uma chamada de ferramenta no estilo OpenAI.
export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://router.flatkey.ai/v1"
export FLATKEY_ROO_MODEL="replace-with-tool-capable-flatkey-model"
curl "$FLATKEY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_ROO_MODEL"'",
"messages": [
{
"role": "user",
"content": "Call route_check with status ok and do not include prose."
}
],
"tools": [
{
"type": "function",
"function": {
"name": "route_check",
"description": "Return the routing smoke-test status.",
"parameters": {
"type": "object",
"properties": {
"status": { "type": "string" }
},
"required": ["status"]
}
}
}
],
"tool_choice": {
"type": "function",
"function": { "name": "route_check" }
},
"max_tokens": 64
}'Uma resposta saudável deve incluir uma mensagem do assistente com tool_calls. Se essa solicitação falhar, corrija a chave da Flatkey, a base URL, o alias do modelo ou a capacidade do modelo antes de alterar as configurações do Roo Code. Se funcionar, mas o Roo Code falhar, concentre-se nos campos salvos do Roo Code, no acesso à rede local, no estado da extensão ou no Model ID exato inserido nas configurações do provedor.
Modos de falha a depurar primeiro
| Sintoma | Causa provável | Correção |
|---|---|---|
| Chave de API inválida | A chave foi copiada incorretamente, rotacionada, limitada a outro ambiente ou pertence a um provedor upstream em vez de Flatkey. | Use uma chave Flatkey חדשה? Wait translate only Portuguese. Should be "Use uma chave Flatkey nova, teste com curl e depois cole a mesma chave no Roo Code." |
| Erro de conexão | Base URL incorreta, caminho completo do endpoint colado no campo Base URL, caminho de rede bloqueado ou problema com proxy local. | Verifique a Base URL do provedor a partir da mesma máquina e teste novamente /chat/completions. |
| Modelo não encontrado | O Model ID do Roo Code não corresponde a um alias do Flatkey habilitado para a chave. | Copie o alias exato da página de preços do Flatkey, do catálogo ou da lista de modelos visível na conta. |
| Erro de chamada de ferramenta | O modelo selecionado responde ao chat, mas não oferece suporte a chamadas nativas de ferramenta compatíveis com OpenAI. | Alterne para um alias de modelo com suporte a ferramentas e execute novamente o teste prévio antes de usar o Roo Code. |
| Extensão indisponível | O estado atual de distribuição do Roo Code não oferece suporte ao caminho de instalação ou atualização planejado. | Trate a configuração como manutenção legada e escolha um fluxo de trabalho ativo de agente de codificação para novas implementações. |
| Uso não pode ser reconciliado | A equipe não registrou o proprietário da chave, o alias do modelo, o usuário do Roo Code, o ambiente ou o timestamp. | Adicione uma linha ao runbook antes de expandir o roteamento para mais desenvolvedores. |
Instalação existente ou novo padrão?
A rota Roo Code OpenAI compatible API pode ser útil, mas o aviso de descontinuação da extensão muda a decisão. Use esta tabela antes de pedir que uma equipe dependa dela.
| Situação | Ação recomendada | Por que isso importa |
|---|---|---|
| Instalação existente do Roo Code ainda usada por um desenvolvedor | Documente a rota Flatkey, teste chamadas de ferramenta e mantenha o rollback. | A manutenção pode continuar enquanto a equipe planeja a migração ou substituição. |
| Nova implementação de agente de codificação para toda a equipe | Verifique primeiro a disponibilidade atual da extensão e depois compare alternativas ativas. | Uma extensão descontinuada pode criar risco de suporte, segurança e onboarding. |
| Padronização de um cluster de integração de ferramentas | Use a mesma chave Flatkey, Base URL, model-alias e padrão de registro de uso entre as ferramentas. | A consistência facilita faturamento, depuração e revisão de compras. |
Runbook de produção para Roo Code com Flatkey
Antes que mais desenvolvedores usem a rota Roo Code OpenAI compatible API, registre os fatos operacionais que tornam possível o suporte e a revisão de custos.
| Campo do runbook | Registre isto |
|---|---|
| Escopo do Roo Code | Instalação local existente, imagem da equipe, perfil arquivado ou teste apenas de migração. |
| Chave Flatkey | Proprietário, ambiente, data de rotação e responsável pela revogação. |
| Base URL | A Base URL exata do provedor salva no Roo Code e a data em que foi verificada. |
| Alias do modelo | Model ID do Roo Code, alias do modelo Flatkey, família do endpoint e resultado da chamada nativa de ferramenta. |
| Teste rápido | Status HTTP, motivo de término, total de uso e se tool_calls apareceu. |
| Revisão de uso | Onde os responsáveis de plataforma e finanças verificam volume de solicitações, custo e mudanças inesperadas de modelo. |
| Rollback | Configuração anterior do provedor, alias anterior do modelo e quem pode restaurá-la. |
Fluxo de migração interna
Se a sua equipe estiver padronizando configurações de ferramentas compatíveis com OpenAI no Flatkey, mantenha esta configuração alinhada com o restante do cluster de integração. Use o guia de migração da API compatível com OpenAI como base URL e central de rollback. Para outro padrão de cliente desktop, compare o guia de configuração da API do Cherry Studio. Para roteamento de agente de codificação em máquinas de desenvolvedor, revise o guia cc-switch Claude Code.
Depois que o primeiro prompt seguro do Roo Code funcionar, revise a atual página de preços dos modelos Flatkey e então obtenha uma chave para cada limite separado de usuário, equipe ou ambiente.
Perguntas frequentes
O Roo Code ainda oferece suporte a provedores compatíveis com OpenAI?
A documentação do provedor OpenAI Compatible do Roo Code ainda descreve os campos do provedor: API Provider, Base URL, API Key e Model ID. A página inicial da documentação também diz que a extensão Roo Code foi descontinuada em 15 de maio de 2026, então verifique seu caminho de instalação antes de uma nova implementação.
Qual Base URL devo usar para o provedor Roo Code OpenAI compatible API?
Use a atual Base URL do provedor Flatkey para a sua conta. As verificações autenticadas deste artigo usaram https://router.flatkey.ai/v1, enquanto exemplos públicos podem mudar. No Roo Code, cole apenas a Base URL, não o endpoint completo de chat-completions.
Por que a chamada nativa de ferramentas é necessária?
A documentação do provedor do Roo Code diz que o native tool calling é o único protocolo de ferramentas suportado para provedores compatíveis com OpenAI. Um modelo que consegue responder em chat simples, mas não consegue produzir tool calls no estilo OpenAI, não é suficiente para uma configuração confiável do Roo Code.
O Model ID deve corresponder exatamente ao alias do modelo Flatkey?
Sim. Use o alias exato do Flatkey que sua chave pode chamar e verifique-o com um teste rápido de tool call. Nomes de família de modelos, nomes de marketing do provedor e aliases do gateway podem ser diferentes.
Posso usar este guia para novas implantações do Roo Code?
Use-o somente depois de verificar a disponibilidade atual do Roo Code. As checagens de roteamento do Flatkey ainda são úteis, mas o aviso de descontinuação do Roo Code significa que novas implantações para toda a equipe precisam de uma decisão explícita de suporte ao produto.
Conclusão
Uma configuração segura da Roo Code OpenAI compatible API via Flatkey deve comprovar mais do que uma resposta de chat bem-sucedida. Confirme a URL base atual, use uma chave de propriedade do Flatkey, selecione um alias exato do modelo, teste native tool calls e verifique a visibilidade de uso antes de dar ao Roo Code acesso a trabalho real de código. Quando a rota estiver pronta para outro usuário ou ambiente, Get a key e mantenha a linha de rollback ao lado das instruções de configuração.
