Guide de l’API

Configurer Claude Code, Cline ou n’importe quel SDK avec votre crédit AIGROW

Une configuration courte et simple pour l’endpoint AIGROW. Activez votre code, créez une clé, indiquez l’URL de base dans n’importe quel outil compatible OpenAI ou Anthropic, et envoyez une requête. Aucun SDK de notre part à installer.

Compatible avec Claude Code, Cline, Aider, OpenCode, Zed, les SDK OpenAI et Anthropic, et curl.

L’endpoint de l’API AIGROW remplace directement les API OpenAI et Anthropic. Utilisez https://aigrow.gg comme URL de base Anthropic ou https://aigrow.gg/v1 comme URL de base OpenAI, authentifiez-vous avec votre clé ag_ et envoyez l’identifiant exact du modèle indiqué dans le catalogue. Le crédit s’ajoute en activant sur le tableau de bord le code figurant sur votre reçu.

Configuration avec un agent IA

La plupart des gens confient cette tâche à un agent de code. Collez le bloc dans Claude Code, Cursor, Cline ou n’importe quel agent : il se configure tout seul. Remplacez ensuite la clé par la vôtre.

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

Il contient les deux protocoles, les noms des en-têtes, la règle de l’identifiant exact et les limites, soit tout ce qu’un agent rate au premier essai.

Activez votre code

C’est la seule étape propre à AIGROW. Elle prend moins d’une minute.

Connectez-vous au tableau de bordOuvrez aigrow.gg/dashboard et connectez-vous, ou créez un compte avec n’importe quelle adresse e-mail. Le code n’est pas lié à l’adresse utilisée pour payer.1 minute
Collez votre codeRendez-vous dans Accès API, collez le code reçu par e-mail dans Activer un code, et votre solde se met à jour immédiatement.Instantané
Créez une cléToujours dans Accès API, créez une clé. Elle commence par ag_ et ne s’affiche qu’une fois : copiez-la directement dans votre outil.Affichée une seule fois

Les deux éléments dont chaque outil a besoin

Une URL de base et votre clé. Choisissez l’URL de base qui correspond à votre outil.

URL de base Anthropic

Pour Claude Code, Claude Desktop et le SDK Anthropic.

https://aigrow.gg
URL de base OpenAI

Pour Cline, Aider, OpenCode, le SDK OpenAI et la plupart des autres outils.

https://aigrow.gg/v1

Envoyez l’identifiant du modèle exactement tel qu’il figure dans le catalogue, par exemple claude-opus-5.5. La grille tarifaire donne tous les identifiants et leur coût, ou envoyez GET /v1/models avec votre clé pour obtenir la liste à jour.

Connectez votre outil

Chaque outil a sa propre page : le bloc exact, où le placer, quel identifiant de modèle envoyer et ce que signifie chaque erreur.

  • Claude CodeProtocole Anthropic

    Quatre variables d’environnement, dans le shell ou dans settings.json.

  • ClineProtocole OpenAI

    Le fournisseur OpenAI Compatible, quatre champs dans l’écran des paramètres.

  • Roo CodeProtocole OpenAI

    Le fournisseur OpenAI Compatible, avec les mêmes champs que dans Cline.

  • Kilo CodeProtocole OpenAI

    Un fournisseur personnalisé dans l’onglet Providers ; la liste des modèles se remplit toute seule.

  • ContinueProtocole OpenAI

    Une entrée models dans config.yaml, avec provider openai et un apiBase.

  • AiderProtocole OpenAI

    OPENAI_API_BASE et OPENAI_API_KEY, puis openai/ avant l’identifiant du modèle.

  • OpenCodeProtocole OpenAI

    Un bloc provider dans opencode.json et la clé via /connect.

  • ZedProtocoles Anthropic et OpenAI

    Un fournisseur compatible Anthropic pour Claude, un fournisseur compatible OpenAI pour GPT et Grok.

  • GooseProtocole OpenAI

    Le fournisseur OpenAI avec OPENAI_HOST, ou un fichier de fournisseur personnalisé.

  • Vercel AI SDKProtocoles Anthropic et OpenAI

    Le fournisseur OpenAI Compatible pour tous les modèles, ou le fournisseur Anthropic pour Claude.

  • OpenAI Agents SDKProtocole OpenAI

    Votre propre client AsyncOpenAI, basculé sur chat completions, avec le traçage désactivé.

  • LangChainProtocoles Anthropic et OpenAI

    ChatOpenAI avec base_url pour tous les modèles, ou ChatAnthropic pour Claude.

Les SDK et curl

Copiez le bloc et remplacez la clé par la vôtre.

OpenAI SDK (Python)

Définissez base_url et api_key lors de la création du 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)

Définissez base_url et api_key lors de la création du 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)

Une première requête en ligne de commande, pour vérifier que la clé fonctionne.

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 même requête avec le protocole 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"}]
  }'

Vous utilisez le Vercel AI SDK, le SDK OpenAI Agents ou LangChain ? Chacun demande un réglage de plus pour rester sur chat completions, et sa page contient le bloc correspondant.

Endpoints et limites

Les mêmes chemins que les API officielles, avec un plafond de trafic partagé.

Endpoints

Envoyez vos requêtes à ces chemins.

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

Partagées entre tous les utilisateurs de l’endpoint.

20 requests / minute
4 requests in flight at once

Avec le protocole Anthropic, chaque requête doit inclure max_tokens. Le streaming fonctionne avec les deux protocoles, et une requête en streaming coûte exactement le même prix qu’une requête sans streaming.

Surveillez votre crédit

Chaque requête est facturée au tarif publié de son modèle et prélevée sur votre solde.

La page Accès API affiche votre solde, vos clés et un journal d’activité indiquant le modèle et le coût de chaque requête : votre solde n’a plus rien de mystérieux. Quand il s’épuise, activez un autre code ou achetez un pack : le crédit s’ajoute au même compte et toutes vos clés continuent de fonctionner.

En cas de problème

Les quelques pièges habituels, et la solution en une ligne pour chacun.

La clé est absente ou mal saisie. Copiez-la de nouveau depuis Accès API sur le tableau de bord, et vérifiez qu’elle est bien transmise comme clé, et non comme nom de modèle. Une clé révoquée provoque la même erreur : créez-en une nouvelle et remplacez-la.

Votre solde est vide. Ouvrez Accès API sur le tableau de bord, activez un code ou achetez un autre pack, et la requête suivante passera. Rien d’autre à modifier.

Le modèle doit être l’un de ceux que l’endpoint propose, par exemple claude-opus-5.5. Les écritures propres aux fournisseurs fonctionnent aussi (claude-opus-5-5, anthropic/claude-opus-5.5), mais un identifiant daté ou tout modèle hors du catalogue est rejeté avant que la requête soit transmise, et rien n’est facturé. Envoyez GET /v1/models avec votre clé pour obtenir la liste à jour, ou consultez les identifiants dans la grille tarifaire.

Avec le protocole Anthropic (/v1/messages), chaque requête doit définir max_tokens. Ajoutez-le, par exemple "max_tokens": 512, et la requête passe. Le protocole OpenAI ne l’exige pas.

La capacité de l’endpoint est partagée entre tous les clients : environ 20 requêtes par minute et 4 simultanément. Chaque erreur 429 contient un en-tête retry-after, et les SDK OpenAI et Anthropic attendent ce délai puis réessaient automatiquement. Dans votre propre boucle, attendez le nombre de secondes indiqué ou réduisez le nombre de requêtes simultanées.

Une erreur 404 indiquant que le modèle n’est pas disponible pour le moment signifie qu’il est brièvement hors service chez le fournisseur en amont. Ce n’est pas un problème lié à votre clé ou à votre solde. Réessayez dans un instant ou envoyez la requête à un autre modèle.

Un incident passager en amont ou de configuration, sans débit sur votre solde. Réessayez la requête ; si l’échec persiste, contactez-nous via la boutique et nous examinerons le problème.

Oui. Les réponses en streaming passent directement, aussi bien avec le protocole OpenAI qu’Anthropic, et la consommation est mesurée à partir du flux : une requête en streaming coûte donc autant qu’une requête classique.

Voilà toute la configuration.

Activez le code, créez une clé, définissez l’URL de base, envoyez une requête. Les mêmes modèles, jusqu’à 75 % sous le prix public.

Compatible OpenAI et Anthropic · tableau de bord de consommation inclus · sans engagement