Comment connecter OpenCode à CheapTokens (opencode.json)

Pour connecter OpenCode à CheapTokens, ajoutez un fournisseur personnalisé compatible OpenAI : stockez votre clé API avec /connect (ID du fournisseur cheaptokens), puis décrivez le fournisseur dans opencode.json avec l'URL de base https://api.cheaptokens.dev/v1. Ensuite, vos modèles CheapTokens apparaissent dans /models.

Ce guide suit la documentation des fournisseurs d'OpenCode (page mise à jour le 20 octobre 2026 ; vérifiée le 22 octobre 2026). La même approche fonctionne pour les autres outils de cette série : Cline, Aider et Kilo Code.

Ce dont vous avez besoin#

• OpenCode installé (consultez sa documentation pour votre plateforme).
• Une clé API CheapTokens. Créez-en une dans votre compte et rechargez le solde ; un seul solde couvre tous les modèles. Les bases sont dans la documentation CheapTokens.
• Les informations sur l'API :
  • URL de base : https://api.cheaptokens.dev/v1
  • compatibilité : OpenAI Chat Completions et Anthropic Messages
  • ID de modèle utilisé ci-dessous : deepseek-ai/DeepSeek-V4-Flash-0731 (contexte de 380K, jusqu'à 32 768 jetons de sortie). Les ID de modèle sont listés dans la documentation CheapTokens : les noms diffèrent selon les fournisseurs, copiez donc l'ID depuis là.

Étape 1. Stocker la clé avec /connect#

1. Lancez OpenCode dans votre projet et exécutez /connect.
2. Faites défiler jusqu'à Other.
3. Saisissez un ID de fournisseur unique : cheaptokens.
4. Collez votre clé API CheapTokens.

Cette étape ne fait que stocker l'identifiant. OpenCode ne connaît toujours pas l'adresse ni les modèles du fournisseur : c'est le rôle de opencode.json.

Étape 2. Décrire le fournisseur dans opencode.json#

Créez ou modifiez opencode.json et ajoutez le fournisseur. L'ID du fournisseur dans provider doit correspondre à celui que vous avez saisi dans /connect.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cheaptokens": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CheapTokens",
      "options": {
        "baseURL": "https://api.cheaptokens.dev/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek-V4-Flash",
          "limit": {
            "context": 380000,
            "output": 32768
          }
        }
      }
    }
  }
}

Ce que fait chaque partie :

• npm — @ai-sdk/openai-compatible est le paquet pour les points de terminaison qui utilisent /v1/chat/completions, ce que CheapTokens expose. (OpenCode utilise @ai-sdk/openai pour les points de terminaison construits sur /v1/responses.)
• name — le libellé affiché dans l'interface OpenCode.
• options.baseURL — l'adresse de l'API CheapTokens.
• models — indexé par ID de modèle ; le name à l'intérieur est un nom d'affichage.
• limit.context / limit.output — facultatifs ; ils indiquent à OpenCode la fenêtre de contexte du modèle et la longueur maximale de réponse.

Garder la clé dans une variable d'environnement à la place (facultatif)#

Si vous préférez ne pas garder la clé dans le magasin d'identifiants d'OpenCode, ajoutez apiKey à options avec la syntaxe {env:VARIABLE} recommandée par la documentation :

"options": {
  "baseURL": "https://api.cheaptokens.dev/v1",
  "apiKey": "{env:CHEAPTOKENS_API_KEY}"
}

Puis exportez CHEAPTOKENS_API_KEY dans votre shell. Ne validez pas une vraie clé dans le dépôt. Si vous débutez avec les clés, lisez ce qu'est une clé API et comment la stocker en toute sécurité.

Étape 3. Vérifier que cela fonctionne#

Exécutez /models et choisissez DeepSeek-V4-Flash sous le fournisseur CheapTokens. Envoyez ensuite une courte invite, par exemple : « Résume en trois phrases ce que fait ce dépôt. » Une réponse normale signifie que l'URL de base, la clé et l'ID de modèle sont tous corrects.

Quel modèle CheapTokens choisir#

Ajoutez autant d'entrées que vous le souhaitez à models — chacune est un bloc comme celui ci-dessus, avec son propre ID.

Pour une session OpenCode, qui envoie de nombreuses requêtes en boucle, DeepSeek-V4-Flash est un bon choix par défaut : la sortie est moins chère que le prix de référence d'OpenRouter, les réponses peuvent atteindre 32 768 jetons, et le prix n'a pas d'heures de pointe. MiniMax-M2.7 est également moins cher que les prix de référence d'OpenRouter en entrée comme en sortie. La sortie de GLM-5.3-Flash est aussi moins chère que le prix de référence d'OpenRouter. Prix actuels (vérifiés en direct, aucun chiffre susceptible de devenir obsolète) :

Pour estimer une session de travail, par exemple 20 requêtes avec 100 000 jetons d'entrée et 5 000 jetons de sortie chacune :

Voir tous les prix et la page DeepSeek pour en savoir plus.

Si cela ne fonctionne pas#

• Le fournisseur ou les modèles sont absents de /models. Vérifiez que opencode.json est un JSON valide (pas de virgules finales) et que la clé sous provider est exactement l'ID que vous avez saisi dans /connect. Si les deux sont corrects, redémarrez OpenCode.
• 401 / erreur d'authentification. Réexécutez /connect et collez à nouveau la clé, ou vérifiez la variable CHEAPTOKENS_API_KEY dans le shell où OpenCode démarre.
• 404 ou « model not found ». L'ID de modèle dans models doit correspondre à l'ID CheapTokens caractère par caractère, y compris le préfixe du fournisseur (deepseek-ai/…).
• Erreurs de connexion. L'URL de base doit se terminer par /v1 et ne contenir aucun chemin supplémentaire. Voir les erreurs de connexion courantes.
• « Not enough tokens ». Rechargez le solde ; voir ce que signifie l'erreur.

Étapes suivantes#

Vous avez maintenant OpenCode fonctionnant sur CheapTokens avec un seul solde pour tous les modèles. Obtenez une clé et effectuez votre premier appel depuis la documentation CheapTokens.