Comment ajouter un fournisseur personnalisé à OpenCode ?

Exécutez /connect, choisissez Other et enregistrez votre clé sous un identifiant de fournisseur, puis ajoutez à opencode.json un fournisseur portant cet identifiant, avec npm défini sur @ai-sdk/openai-compatible et options.baseURL défini sur https://aigrow.gg/v1.

Où OpenCode conserve-t-il la clé ?

Dans ~/.local/share/opencode/auth.json après /connect. opencode auth list indique quels fournisseurs en ont une.

Quel paquet npm le fournisseur utilise-t-il ?

@ai-sdk/openai-compatible, qui appelle /v1/chat/completions. @ai-sdk/openai appelle /v1/responses, que le point d’accès ne propose pas.

OpenCode avec un fournisseur personnalisé

Ajoutez ce fournisseur à opencode.json et donnez-lui votre clé avec /connect : OpenCode fonctionne alors avec les modèles Claude, GPT et Grok via votre clé AIGROW.

Acheter du crédit API

Vous avez déjà un code ? Utilisez-le sur l’accès API, puis créez une clé.

opencode.json dans votre projet

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aigrow": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AIGROW",
      "options": { "baseURL": "https://aigrow.gg/v1" },
      "models": { "claude-opus-5.5": { "name": "Claude Opus 5.5" } }
    }
  }
}

Remplacez ag_your_key_here par une clé obtenue sur l’accès API.

Où se trouve le réglage

Un projet: opencode.json
Tous les projets: ~/.config/opencode/opencode.json
La clé, après /connect: ~/.local/share/opencode/auth.json

Enregistrer la cléDans OpenCode, exécutez /connect, faites défiler jusqu’à Other et saisissez aigrow comme identifiant du fournisseur.

Collez votre cléCollez votre clé AIGROW quand OpenCode la demande.

Ajouter le fournisseurPlacez le bloc dans opencode.json. L’identifiant du fournisseur dans le fichier doit correspondre à celui saisi dans /connect.

Plus de modèles et un modèle par défaut

Listez tous les modèles que vous voulez dans le sélecteur, et définissez model pour qu’OpenCode démarre sur l’un d’eux.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aigrow": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AIGROW",
      "options": { "baseURL": "https://aigrow.gg/v1" },
      "models": {
        "claude-opus-5.5": { "name": "Claude Opus 5.5" },
        "grok-4.7": { "name": "Grok 4.7" },
        "gpt-6-astra": { "name": "GPT-6 Astra" }
      }
    }
  },
  "model": "aigrow/claude-opus-5.5"
}

Quel modèle choisir

Saisissez l’identifiant exactement comme il est écrit ici.

Claude Opus 5.5claude-opus-5.5: Le modèle par défaut dans chaque bloc de cette page, et le modèle Claude le moins cher ici par token envoyé et reçu. Contexte : 1 000 000 tokens.
Grok 4.7grok-4.7: Le prix de sortie le plus bas ici. Son contexte fait la moitié de celui des modèles Claude. Contexte : 500 000 tokens.
GPT-6 Astragpt-6-astra: Pour un modèle GPT. Il coûte autant par token que Fable, et plus qu’Opus. Contexte : 1 050 000 tokens.
Claude Fable 5.1claude-fable-5.1: Coûte plus cher par token qu’Opus. Comparez les deux dans le classement du code avant de changer. Contexte : 1 000 000 tokens.

La grille tarifaire indique chaque identifiant et son tarif en crédits, les tarifs de l’API Claude donnent les prix publics, et le classement des modèles pour le code compare les modèles sur des requêtes de programmation.

Vérifier que tout fonctionne

D’abord la clé seule, puis OpenCode avec cette clé.

La clé

Demandez la liste des modèles. Il faut une clé valide, et cela ne coûte rien.

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

Avec une clé valide, vous recevez la liste en retour :

{
  "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
}

OpenCode

Exécutez /models, choisissez un modèle sous AIGROW et envoyez cette requête.

Reply with the word ready

Une configuration qui fonctionne répond dans la session :

ready

En cas d’échec

D’abord les erreurs propres à OpenCode, puis les réponses que l’endpoint renvoie à n’importe quel outil.

Le fournisseur n’a pas de clé: Exécutez opencode auth list. Si aigrow est absent, relancez /connect et vérifiez que l’identifiant correspond à celui d’opencode.json.
Erreur 404 avec @ai-sdk/openai: Ce paquet appelle l’API Responses, que le point d’accès ne propose pas. Utilisez @ai-sdk/openai-compatible, comme dans le bloc.
Mon outil affiche une erreur 401 ou d’authentification: 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.
J’obtiens une erreur 402 ou un message sur le crédit: 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.
J’obtiens une erreur 404 ou « Unknown model »: 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.
Les requêtes sont rejetées avec l’erreur 429: 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.
Le modèle est indisponible pour le moment: 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.
J’obtiens une erreur 502 ou 503: 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.

Ce qui ne fonctionne pas avec AIGROW

Le paquet @ai-sdk/openai, qui appelle /v1/responses. Tous les modèles ci-dessus fonctionnent avec @ai-sdk/openai-compatible.
Recherche web en direct au sein du modèle. Un outil de recherche web envoyé avec une requête reçoit une réponse fondée sur ce que le modèle sait déjà, sans résultats en direct. Un outil qui récupère des pages sur votre propre machine continue de fonctionner.
Tout point d’accès autre que ces trois : /v1/messages, /v1/chat/completions et /v1/models. L’API Responses, les embeddings et le comptage de tokens renvoient une erreur 404.
Les champs de routage tels que models, route, provider et plugins. Ils sont ignorés : une requête va donc toujours au seul modèle qu’elle indique.

Ce que coûte un mois d’utilisation d’OpenCode

L’utilisation d’OpenCode est facturée au token, aux tarifs en crédits de la grille tarifaire. Un agent renvoie toute la conversation à chaque étape : une longue tâche coûte donc plus que son dernier message ne le laisse penser. Le journal d’activité de l’accès API indique le coût de chaque requête.

Questions sur OpenCode et une API personnalisée

Comment ajouter un fournisseur personnalisé à OpenCode ?: Exécutez /connect, choisissez Other et enregistrez votre clé sous un identifiant de fournisseur, puis ajoutez à opencode.json un fournisseur portant cet identifiant, avec npm défini sur @ai-sdk/openai-compatible et options.baseURL défini sur https://aigrow.gg/v1.
Où OpenCode conserve-t-il la clé ?: Dans ~/.local/share/opencode/auth.json après /connect. opencode auth list indique quels fournisseurs en ont une.
Quel paquet npm le fournisseur utilise-t-il ?: @ai-sdk/openai-compatible, qui appelle /v1/chat/completions. @ai-sdk/openai appelle /v1/responses, que le point d’accès ne propose pas.

Sources : OpenCode Providers · OpenCode Config. Consulté le 21 octobre 2026.

Configurer un autre outil

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

Le guide de l’API présente les SDK, curl, les endpoints et les limites de débit.

Collez le bloc : OpenCode fonctionne alors avec votre crédit.

Achetez un pack de crédits, utilisez le code reçu par e-mail sur l’accès API, créez une clé et placez-la à la place de ag_your_key_here.

Acheter du crédit API Voir les prix et les modèles