Que fornecedor do Roo Code devo escolher para uma API personalizada?

OpenAI Compatible. Aceita qualquer URL base, chave e id de modelo, por isso o mesmo fornecedor executa os modelos Claude, GPT e Grok em https://aigrow.gg/v1.

O Roo Code precisa de chamada de ferramentas?

Sim. O Roo Code chama as suas ferramentas apenas através de chamada de ferramentas nativa, e o endpoint reencaminha as chamadas de ferramentas da OpenAI, por isso funciona qualquer modelo que as suporte.

O Base URL deve terminar em /v1?

Sim. O Roo Code acrescenta /chat/completions ao Base URL, por isso o valor é https://aigrow.gg/v1. Sem /v1, os pedidos falham com um erro 404.

Roo Code com um fornecedor OpenAI compatible

Preencha estes quatro campos nas definições do Roo Code e o Roo Code passa a funcionar com modelos Claude, GPT e Grok através da sua chave AIGROW.

Comprar crédito de API

Já tem um código? Resgate-o em Acesso à API e depois crie uma chave.

Definições do Roo Code, ícone da engrenagem

API Provider:  OpenAI Compatible
Base URL:      https://aigrow.gg/v1
API Key:       ag_your_key_here
Model:         claude-opus-5.5

Substitua ag_your_key_here por uma chave de Acesso à API.

Onde fica a definição

Abra as definiçõesClique no ícone da engrenagem no painel do Roo Code.

Escolha o fornecedorDefina API Provider como OpenAI Compatible.

Preencha os camposCole o Base URL, a sua chave em API Key e um id de modelo da lista abaixo em Model.

Defina a janela de contextoEm Model Configuration, defina Context Window como 1000000. Os preços aí indicados servem apenas para a estimativa do próprio Roo Code; o acesso à API mostra o que cada pedido realmente custou.

Que modelo usar

Introduza o id exatamente como está escrito aqui.

Claude Opus 5.5claude-opus-5.5: A opção predefinida em todos os blocos desta página e o modelo Claude mais barato aqui por token enviado e recebido. Contexto: 1 000 000 tokens.
Grok 4.7grok-4.7: O preço de saída mais baixo aqui. O seu contexto tem metade do tamanho dos modelos Claude. Contexto: 500 000 tokens.
GPT-6 Astragpt-6-astra: Para um modelo GPT. Custa o mesmo por token que o Fable e mais do que o Opus. Contexto: 1 050 000 tokens.
Claude Fable 5.1claude-fable-5.1: Custa mais por token do que o Opus. Compare os dois no ranking de programação antes de mudar. Contexto: 1 000 000 tokens.

A lista de preços tem todos os ids e a respetiva taxa de crédito, os preços da API do Claude indicam os preços de tabela e o ranking de programação compara os modelos em prompts de programação.

Verifique se funciona

Primeiro a chave isolada, depois o Roo Code com ela.

A chave

Peça a lista de modelos. Requer uma chave válida e não custa nada.

curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"

Uma chave válida devolve a lista:

{
  "object": "list",
  "data": [
    { "id": "claude-opus-5.5", "object": "model", ... },
    { "id": "claude-fable-5.1", "object": "model", ... },
    { "id": "gpt-6-astra", "object": "model", ... },
    { "id": "claude-sonnet-5.5", "object": "model", ... },
    { "id": "gpt-6.1-sol", "object": "model", ... },
    { "id": "grok-4.7", "object": "model", ... },
    ...
  ],
  "has_more": false
}

Roo Code

Inicie uma nova tarefa no painel do Roo Code e envie este prompt.

Reply with the word ready

Uma configuração correta responde no chat:

ready

Quando falha

Primeiro os erros do Roo Code, depois as respostas que o endpoint dá a qualquer ferramenta.

404 em todos os pedidos: Falta /v1 no Base URL. No protocolo da OpenAI, o valor é https://aigrow.gg/v1.
A minha ferramenta indica 401 ou erro de autenticação: A chave está em falta ou foi escrita incorretamente. Copie-a de novo em Acesso à API no painel e certifique-se de que é enviada como chave, e não como nome de modelo. Uma chave revogada falha da mesma forma: crie uma nova e substitua-a.
Recebo 402 ou uma mensagem sobre crédito: O seu saldo está vazio. Abra Acesso à API no painel, resgate um código ou compre outro pacote e o pedido seguinte será processado. Não é preciso mudar mais nada.
Aparece 404 ou Unknown model: O modelo tem de ser um dos que o endpoint disponibiliza, por exemplo claude-opus-5.5. A grafia própria do fornecedor também funciona (claude-opus-5-5, anthropic/claude-opus-5.5), mas um id com data ou qualquer modelo fora do catálogo é rejeitado antes de o pedido ser encaminhado e nada é cobrado. Peça GET /v1/models com a sua chave para obter a lista atual, ou consulte os ids na lista de preços.
Os pedidos são rejeitados com 429: A capacidade do endpoint é partilhada por todos os clientes: cerca de 20 pedidos por minuto e 4 em simultâneo. Cada resposta 429 inclui um cabeçalho retry-after, e os SDKs da OpenAI e da Anthropic esperam esse tempo e voltam a tentar por conta própria. Num ciclo seu, aguarde os segundos indicados ou reduza a concorrência.
O modelo está indisponível neste momento: Um 404 que indica que o modelo não está disponível neste momento significa que ele está brevemente em baixo no fornecedor de origem, e não um problema com a sua chave ou saldo. Tente novamente daqui a pouco ou envie o pedido para outro modelo.
Recebo um 502 ou 503: Uma falha transitória na origem ou na configuração, sem qualquer cobrança no seu saldo. Repita o pedido; se continuar a falhar, contacte-nos através da loja e vamos analisar.

O que não funciona através da AIGROW

Pesquisa web em tempo real dentro do modelo. Uma ferramenta de pesquisa web enviada num pedido é respondida com o que o modelo já sabe, sem resultados em tempo real. Uma ferramenta que obtém páginas na sua própria máquina continua a funcionar.
Qualquer endpoint além destes três: /v1/messages, /v1/chat/completions e /v1/models. A Responses API, os embeddings e a contagem de tokens respondem 404.
Campos de router como models, route, provider e plugins. São descartados, por isso um pedido vai sempre para o único modelo que indica.

Quanto custa um mês de Roo Code

O Roo Code é faturado por token às taxas de crédito da lista de preços. Um agente volta a enviar a conversa inteira a cada passo, por isso uma tarefa longa custa mais do que a última mensagem sugere; o registo de atividade em Acesso à API mostra quanto custou cada pedido.

Perguntas sobre o Roo Code e uma API personalizada

Que fornecedor do Roo Code devo escolher para uma API personalizada?: OpenAI Compatible. Aceita qualquer URL base, chave e id de modelo, por isso o mesmo fornecedor executa os modelos Claude, GPT e Grok em https://aigrow.gg/v1.
O Roo Code precisa de chamada de ferramentas?: Sim. O Roo Code chama as suas ferramentas apenas através de chamada de ferramentas nativa, e o endpoint reencaminha as chamadas de ferramentas da OpenAI, por isso funciona qualquer modelo que as suporte.
O Base URL deve terminar em /v1?: Sim. O Roo Code acrescenta /chat/completions ao Base URL, por isso o valor é https://aigrow.gg/v1. Sem /v1, os pedidos falham com um erro 404.

Fontes: Roo Code OpenAI Compatible · Roo Code Anthropic. Consultado em 21 de outubro de 2026.

Configurar outra ferramenta

Claude CodeProtocolo Anthropic
Quatro variáveis de ambiente, na shell ou no settings.json.
ClineProtocolo OpenAI
O fornecedor OpenAI Compatible, quatro campos no ecrã de definições.
Kilo CodeProtocolo OpenAI
Um fornecedor personalizado no separador Providers; a lista de modelos preenche-se sozinha.
ContinueProtocolo OpenAI
Uma entrada models no config.yaml, com provider openai e um apiBase.
AiderProtocolo OpenAI
OPENAI_API_BASE e OPENAI_API_KEY, depois openai/ antes do ID do modelo.
OpenCodeProtocolo OpenAI
Um bloco provider no opencode.json e a chave através de /connect.
ZedProtocolos Anthropic e OpenAI
Um fornecedor compatível com Anthropic para Claude, um compatível com OpenAI para GPT e Grok.
GooseProtocolo OpenAI
O fornecedor OpenAI com OPENAI_HOST, ou um ficheiro de fornecedor personalizado.
Vercel AI SDKProtocolos Anthropic e OpenAI
O fornecedor OpenAI Compatible para todos os modelos, ou o fornecedor Anthropic para o Claude.
OpenAI Agents SDKProtocolo OpenAI
O seu próprio cliente AsyncOpenAI, mudado para chat completions, com o tracing desativado.
LangChainProtocolos Anthropic e OpenAI
ChatOpenAI com base_url para todos os modelos, ou ChatAnthropic para o Claude.

O guia da API inclui os SDKs, o curl, os endpoints e os limites de utilização.

Cole o bloco e o Roo Code passa a funcionar com o seu crédito.

Compre um pacote de crédito, resgate o código do seu email em Acesso à API, crie uma chave e coloque-a no lugar de ag_your_key_here.

Comprar crédito de API Ver preços e modelos