Guia da API

Configure o Claude Code, o Cline ou qualquer SDK com crédito AIGROW

Uma configuração curta e simples para o endpoint da AIGROW. Resgate o seu código, crie uma chave, aponte qualquer ferramenta compatível com a OpenAI ou a Anthropic para o URL base e envie um pedido. Sem nenhum SDK nosso para instalar.

Abrir Acesso à APIIr para a sua ferramenta

Funciona com Claude Code, Cline, Aider, OpenCode, Zed, os SDKs da OpenAI e da Anthropic, e curl.

O endpoint da API da AIGROW substitui diretamente as APIs da OpenAI e da Anthropic. Use https://aigrow.gg como URL base da Anthropic ou https://aigrow.gg/v1 como URL base da OpenAI, autentique-se com a sua chave ag_ e envie o id exato do modelo indicado no catálogo. O crédito chega ao resgatar no painel o código do seu recibo.

Configurar com um agente de IA

A maioria das pessoas entrega isto a um agente de programação. Cole o bloco no Claude Code, no Cursor, no Cline ou em qualquer agente e ele configura-se sozinho; depois, substitua a chave por uma sua.

AIGROW API gateway: an OpenAI- and Anthropic-compatible endpoint.
Configure a client with ONE of these two wires. The key starts with ag_.

Anthropic wire
  base URL   https://aigrow.gg            (the SDK appends /v1/messages)
  header     x-api-key: ag_your_key_here  (or Authorization: Bearer ag_your_key_here)
  header     anthropic-version: 2023-06-01
  body       max_tokens is required on every request

OpenAI wire
  base URL   https://aigrow.gg/v1         (POST /chat/completions)
  header     Authorization: Bearer ag_your_key_here

Model ids: claude-opus-5.5, claude-fable-5.1, gpt-6-astra, claude-sonnet-5.5, gpt-6.1-sol, grok-4.7
The provider's own spellings work too (claude-opus-5-5, anthropic/claude-opus-5.5).
A date suffix or any other model is rejected with 404 "Unknown model" before
the request is forwarded, and nothing is billed.
Claude Code: also set ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-sonnet-5.5, since its
background calls default to a Haiku model the endpoint does not serve.
Call GET /v1/models with the key for the live list of ids.

Endpoints: POST /v1/messages (Anthropic), POST /v1/chat/completions (OpenAI),
GET /v1/models. Streaming is supported on both wires.
Capacity: about 20 requests per minute and 4 in flight, shared. Past it a
request gets 429 with a retry-after header; wait that long and send it again.
Full guide: https://aigrow.gg/ai-api/guide

Inclui os dois protocolos, os nomes dos cabeçalhos, a regra do id exato e os limites, ou seja, tudo aquilo em que um agente costuma errar à primeira.

Resgate o seu código

Este é o único passo exclusivo da AIGROW. Demora menos de um minuto.

Inicie sessão no painelAbra aigrow.gg/dashboard e inicie sessão, ou crie uma conta com qualquer endereço de email. O código não está associado ao endereço com que pagou.1 minuto
Cole o seu códigoAbra Acesso à API, cole o código do email de resgate em Resgatar um código e o seu saldo é atualizado de imediato.Instantâneo
Crie uma chaveAinda em Acesso à API, crie uma chave. Começa por ag_ e é mostrada apenas uma vez, por isso copie-a diretamente para a sua ferramenta.Mostrada uma só vez

As duas coisas de que qualquer ferramenta precisa

Um URL base e a sua chave. Escolha o URL base que corresponde à ferramenta.

URL base da Anthropic

Para o Claude Code, o Claude Desktop e o SDK da Anthropic.

https://aigrow.gg
URL base da OpenAI

Para Cline, Aider, OpenCode, o SDK da OpenAI e a maioria das outras ferramentas.

https://aigrow.gg/v1

Envie o id do modelo exatamente como o catálogo o apresenta, por exemplo claude-opus-5.5. A lista de preços tem todos os ids e o respetivo custo, ou faça GET /v1/models com a sua chave para obter a lista em tempo real.

Ligue a sua ferramenta

Cada ferramenta tem a sua própria página: o bloco exato, onde o colocar, que id de modelo enviar e o que significa cada erro.

  • 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.

  • Roo CodeProtocolo OpenAI

    O fornecedor OpenAI Compatible, os mesmos campos do Cline.

  • 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.

Os SDKs e o curl

Copie o bloco e substitua a chave pela sua.

OpenAI SDK (Python)

Defina base_url e api_key ao criar o cliente.

from openai import OpenAI

client = OpenAI(
    base_url="https://aigrow.gg/v1",
    api_key="ag_your_key_here",
)

resp = client.chat.completions.create(
    model="claude-opus-5.5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

Anthropic SDK (Python)

Defina base_url e api_key ao criar o cliente.

from anthropic import Anthropic

client = Anthropic(
    base_url="https://aigrow.gg",
    api_key="ag_your_key_here",
)

msg = client.messages.create(
    model="claude-opus-5.5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content[0].text)

curl (OpenAI)

Um primeiro pedido a partir da linha de comandos, para confirmar que a chave funciona.

curl https://aigrow.gg/v1/chat/completions \
  -H "Authorization: Bearer ag_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5.5",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

curl (Anthropic)

O mesmo pedido no protocolo da Anthropic.

curl https://aigrow.gg/v1/messages \
  -H "x-api-key: ag_your_key_here" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5.5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Usa o Vercel AI SDK, o OpenAI Agents SDK ou o LangChain? Cada um precisa de mais uma definição para continuar em chat completions, e a respetiva página tem o bloco com ela.

Endpoints e limites

Os mesmos caminhos das APIs oficiais, com um teto de tráfego partilhado.

Endpoints

Envie os pedidos para estes caminhos.

POST /v1/messages          (Anthropic)
POST /v1/chat/completions  (OpenAI)
GET  /v1/models            (list the model ids)
Limites de pedidos

Partilhados por todos os utilizadores do endpoint.

20 requests / minute
4 requests in flight at once

No protocolo Anthropic, todos os pedidos têm de incluir max_tokens. O streaming funciona nos dois protocolos e um pedido em streaming custa exatamente o mesmo que um sem streaming.

Acompanhe o seu crédito

Cada pedido é cobrado à tarifa publicada do respetivo modelo e debitado do seu saldo.

A página Acesso à API mostra o seu saldo, as suas chaves e um registo de atividade com o modelo e o custo de cada pedido, para que o saldo nunca seja um palpite. Quando estiver a acabar, resgate outro código ou compre um pacote: o crédito é adicionado à mesma conta e todas as chaves continuam a funcionar.

Se algo não funcionar

As poucas coisas que costumam causar problemas e a solução de uma linha para cada uma.

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.

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.

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.

No protocolo Anthropic (/v1/messages), todos os pedidos têm de definir max_tokens. Adicione-o, por exemplo "max_tokens": 512, e o pedido passa. O protocolo OpenAI não o exige.

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.

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.

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.

Sim. As respostas em streaming passam diretamente, tanto no protocolo da OpenAI como no da Anthropic, e a utilização é medida a partir do stream, pelo que um pedido em streaming custa o mesmo que um sem streaming.

Esta é toda a configuração.

Resgate, crie uma chave, defina o URL base e envie um pedido. Os mesmos modelos, até 75% abaixo do preço de tabela.

Abrir Acesso à APIVer preços e modelos

Compatível com a OpenAI e a Anthropic · painel de utilização incluído · sem dependência de fornecedor