Guida all’API

Configura Claude Code, Cline o qualsiasi SDK con il credito AIGROW

Una configurazione breve e semplice per l’endpoint AIGROW. Riscatta il tuo codice, crea una chiave, punta qualsiasi strumento compatibile con OpenAI o Anthropic all’URL di base e invia una richiesta. Nessun nostro SDK da installare.

Apri Accesso APIVai al tuo strumento

Funziona con Claude Code, Cline, Aider, OpenCode, Zed, gli SDK di OpenAI e Anthropic e curl.

L’endpoint API di AIGROW sostituisce direttamente le API di OpenAI e Anthropic. Usa https://aigrow.gg come URL di base Anthropic o https://aigrow.gg/v1 come URL di base OpenAI, autenticati con la tua chiave ag_ e invia l’id esatto del modello dal catalogo. Il credito arriva riscattando nella dashboard il codice della tua ricevuta.

Configurazione con un agente AI

Quasi tutti lo affidano a un agente di coding. Incolla il blocco in Claude Code, Cursor, Cline o in qualsiasi agente e si configura da solo, poi sostituisci la chiave con una tua.

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

Contiene entrambi i protocolli, i nomi degli header, la regola dell'id esatto e i limiti, cioè tutto ciò che un agente sbaglia al primo tentativo.

Riscatta il tuo codice

È l’unico passaggio specifico di AIGROW. Richiede meno di un minuto.

Accedi alla dashboardApri aigrow.gg/dashboard e accedi, oppure crea un account con qualsiasi indirizzo email. Il codice non è legato all’indirizzo con cui hai pagato.1 minuto
Incolla il codiceVai su Accesso API, incolla il codice ricevuto nell'email di riscatto in Riscatta un codice e il tuo saldo si aggiorna subito.Immediato
Crea una chiaveSempre in Accesso API, crea una chiave. Inizia con ag_ e viene mostrata una sola volta, quindi copiala subito nel tuo strumento.Mostrata una sola volta

Le due cose che servono a ogni strumento

Un URL di base e la tua chiave. Scegli l’URL di base adatto al tuo strumento.

URL di base Anthropic

Per Claude Code, Claude Desktop e l’SDK di Anthropic.

https://aigrow.gg
URL di base OpenAI

Per Cline, Aider, OpenCode, l'SDK di OpenAI e la maggior parte degli altri strumenti.

https://aigrow.gg/v1

Invia l’id del modello esattamente come appare nel catalogo, ad esempio claude-opus-5.5. Il listino prezzi riporta ogni id e il relativo costo, oppure richiedi GET /v1/models con la tua chiave per l’elenco aggiornato.

Collega il tuo strumento

Ogni strumento ha la sua pagina: il blocco esatto, dove inserirlo, quale id del modello inviare e cosa significa ogni errore.

  • Claude CodeProtocollo Anthropic

    Quattro variabili d’ambiente, nella shell o in settings.json.

  • ClineProtocollo OpenAI

    Il provider OpenAI Compatible, quattro campi nella schermata delle impostazioni.

  • Roo CodeProtocollo OpenAI

    Il provider OpenAI Compatible, con gli stessi campi di Cline.

  • Kilo CodeProtocollo OpenAI

    Un provider personalizzato nella scheda Providers; l’elenco dei modelli si compila da solo.

  • ContinueProtocollo OpenAI

    Una voce in models nel file config.yaml, con provider openai e un apiBase.

  • AiderProtocollo OpenAI

    OPENAI_API_BASE e OPENAI_API_KEY, poi openai/ prima dell’id del modello.

  • OpenCodeProtocollo OpenAI

    Un blocco provider in opencode.json e la chiave tramite /connect.

  • ZedProtocolli Anthropic e OpenAI

    Un provider compatibile con Anthropic per Claude, uno compatibile con OpenAI per GPT e Grok.

  • GooseProtocollo OpenAI

    Il provider OpenAI con OPENAI_HOST, oppure un file di provider personalizzato.

  • Vercel AI SDKProtocolli Anthropic e OpenAI

    Il provider OpenAI Compatible per ogni modello, oppure il provider Anthropic per Claude.

  • OpenAI Agents SDKProtocollo OpenAI

    Il tuo client AsyncOpenAI, passato alle chat completions, con il tracing disattivato.

  • LangChainProtocolli Anthropic e OpenAI

    ChatOpenAI con base_url per ogni modello, oppure ChatAnthropic per Claude.

Gli SDK e curl

Copia il blocco e sostituisci la chiave con la tua.

OpenAI SDK (Python)

Imposta base_url e api_key quando crei il client.

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)

Imposta base_url e api_key quando crei il client.

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)

Una prima richiesta dalla riga di comando, per verificare che la chiave funzioni.

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)

La stessa richiesta sul protocollo 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"}]
  }'

Usi il Vercel AI SDK, l'OpenAI Agents SDK o LangChain? Ognuno richiede un'impostazione in più per restare sulle chat completions, e la sua pagina contiene il blocco con tutto il necessario.

Endpoint e limiti

Gli stessi percorsi delle API ufficiali, con un tetto condiviso al traffico.

Endpoint

Invia le richieste a questi percorsi.

POST /v1/messages          (Anthropic)
POST /v1/chat/completions  (OpenAI)
GET  /v1/models            (list the model ids)
Limiti di frequenza

Condivisi tra tutti gli utenti dell'endpoint.

20 requests / minute
4 requests in flight at once

Sul protocollo Anthropic ogni richiesta deve includere max_tokens. Lo streaming funziona su entrambi i protocolli e una richiesta in streaming costa esattamente quanto una senza streaming.

Tieni d’occhio il credito

Ogni richiesta viene fatturata alla tariffa pubblicata del suo modello e detratta dal tuo saldo.

La pagina Accesso API mostra il saldo, le chiavi e un registro delle attività con modello e costo di ogni richiesta, così il saldo non è mai un’incognita. Quando sta per finire, riscatta un altro codice o acquista un pacchetto: il credito viene aggiunto allo stesso account e ogni chiave continua a funzionare.

Se qualcosa non funziona

I pochi intoppi più comuni, con la soluzione in una riga per ciascuno.

La chiave manca o è stata digitata in modo errato. Copiala di nuovo da Accesso API nella dashboard e assicurati che venga inviata come chiave, non come nome di un modello. Una chiave revocata dà lo stesso errore: creane una nuova e sostituiscila.

Il tuo saldo è esaurito. Apri Accesso API nella dashboard, riscatta un codice o acquista un altro pacchetto e la richiesta successiva andrà a buon fine. Non serve cambiare nient’altro.

Il modello deve essere uno di quelli serviti dall’endpoint, per esempio claude-opus-5.5. Funzionano anche le grafie originali del provider (claude-opus-5-5, anthropic/claude-opus-5.5), ma un id con data o qualsiasi modello fuori dal catalogo viene rifiutato prima che la richiesta sia inoltrata, e non viene addebitato nulla. Con la tua chiave richiedi GET /v1/models per l’elenco aggiornato, oppure leggi gli id nel listino.

Sul protocollo Anthropic (/v1/messages) ogni richiesta deve impostare max_tokens. Aggiungilo, ad esempio "max_tokens": 512, e la richiesta andrà a buon fine. Il protocollo OpenAI non lo richiede.

La capacità dell’endpoint è condivisa da tutti i clienti: circa 20 richieste al minuto e 4 contemporaneamente. Ogni risposta 429 include un header retry-after, e gli SDK di OpenAI e Anthropic attendono quel tempo e riprovano da soli. In un ciclo scritto da te, attendi i secondi indicati oppure riduci la concorrenza.

Un 404 che indica che il modello non è al momento disponibile significa che è temporaneamente fuori servizio presso il provider a monte, non che c'è un problema con la tua chiave o il tuo saldo. Riprova tra qualche istante oppure invia la richiesta a un altro modello.

Un problema temporaneo a monte o di configurazione, che non viene addebitato sul tuo saldo. Riprova la richiesta; se continua a fallire, scrivici tramite lo store e ce ne occuperemo.

Sì. Le risposte in streaming passano direttamente sia sul protocollo OpenAI sia su quello Anthropic, e l’utilizzo viene misurato dallo stream, quindi una richiesta in streaming costa come una senza streaming.

La configurazione finisce qui.

Riscatta, crea una chiave, imposta l’URL di base, invia una richiesta. Gli stessi modelli, fino al 75% sotto il prezzo di listino.

Apri Accesso APIVedi prezzi e modelli

Compatibile con OpenAI e Anthropic · dashboard di utilizzo inclusa · nessun vincolo