TokenLab

Outils de code

OpenCode

Configurer OpenCode pour utiliser l'API TokenLab

Laisser mon agent effectuer cette configuration

Copiez cette tâche vers un agent déjà en cours d'exécution sur votre ordinateur :

Read this guide and help me connect OpenCode to TokenLab:
https://tokenlab.sh/docs/fr/integrations/opencode
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

Aperçu

OpenCode peut utiliser TokenLab via un fournisseur personnalisé compatible avec OpenAI. Ajoutez la clé API TokenLab, l'URL de base (Base URL) et un ID de modèle actuel.

Installation

OpenCode

npm install -g opencode-ai@1.18.31

Vérifiez l'installation :

opencode --version

Configuration

Étape 1 : Définir les variables d'environnement

Utilisez les instructions du terminal Démarrage rapide pour macOS, Linux, WSL ou Windows PowerShell afin de définir TOKENLAB_API_KEY sans inclure la clé dans l'historique des commandes. Lancez OpenCode depuis ce terminal. Pour une utilisation persistante, utilisez votre gestionnaire de secrets local ; n'ajoutez pas de clé en texte clair à votre profil shell.

Étape 2 : Configurer OpenCode

La configuration ci-dessous a été vérifiée avec OpenCode 1.18.31. Les autres versions nécessitent leur propre vérification par rapport à la documentation officielle.

Créez un fichier séparé ~/.config/opencode/tokenlab.jsonc avec la configuration ci-dessous. Si XDG_CONFIG_HOME est défini, utilisez opencode/tokenlab.jsonc dans ce répertoire. Gardez les fichiers opencode.json / opencode.jsonc normaux, les comptes, le modèle par défaut et les autorisations inchangés : ce fichier séparé n'est chargé que pour une invocation qui le sélectionne avec OPENCODE_CONFIG. Si le nom du fichier ou du fournisseur appartient déjà à une autre configuration, choisissez un nom de fichier différent et ajustez les commandes.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenlab": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenLab",
      "options": {
        "baseURL": "https://api.tokenlab.sh/v1",
        "apiKey": "{env:TOKENLAB_API_KEY}"
      },
      "models": {
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        }
      }
    }
  }
}

Cette configuration utilise @ai-sdk/openai-compatible pour les Chat Completions. Choisissez un modèle actuel dont les détails prennent en charge les Chat Completions et les outils dont vous avez besoin ; n'inférez pas la prise en charge d'un autre protocole ou d'une autre version à partir de cet exemple.

Optionnel : l'assistant de configuration reversible OpenCode setup helper permet la prévisualisation, l'application et la restauration des fichiers originaux avec Python 3.11+. Le plugin TokenLab Skills 0.1.2 inclut ces scripts ; une installation autonome de Skill peut également être utilisée après la mise à jour vers une version qui les contient. Pour un plugin existant ou une installation autonome de Skill, suivez les instructions de mise à jour du README et confirmez que le script est présent. La configuration manuelle décrite ici reste utilisable sans l'assistant.

Utilisation de base

Définissez la clé en utilisant le Quickstart, puis chargez ce fichier et sélectionnez le modèle explicitement pour cette invocation. Remplacez votre chemin réel et le nom du fournisseur si vous les avez personnalisés. Conservez toute configuration OPENCODE_CONFIG existante ou OPENCODE_CONFIG_CONTENT en ligne dans un environnement de lancement séparé ; les paramètres du projet et les paramètres gérés peuvent toujours prévaloir.

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode models tokenlab
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode --model tokenlab/gpt-5.6-terra

La découverte de modèles vérifie le chargement local, et non la validité de la clé ou la réussite d'une requête en direct. Une invite utilise le solde TokenLab et OpenCode peut envoyer des requêtes auxiliaires facturées séparément, telles que la génération de titres. Vérifiez la réponse et les enregistrements de requêtes correspondants.

Pour utiliser votre configuration habituelle, lancez sans cette couche. Ne conservez pas OPENCODE_CONFIG dans votre profil shell pour ce guide. Pour annuler la configuration manuelle, supprimez uniquement le fichier séparé que vous avez créé, ou restaurez sa sauvegarde s'il existait auparavant.

Générer des images et des vidéos dans le même agent

OpenCode peut également créer des images et de courtes vidéos avec le serveur MCP TokenLab. Chaque génération est payée à partir du même solde TokenLab. Fusionnez cette entrée mcp dans le même tokenlab.jsonc, à côté de provider. OpenCode remplace {env:TOKENLAB_API_KEY} par la variable de votre terminal, de sorte que la clé n'est pas écrite dans le fichier :

{
  "mcp": {
    "tokenlab": {
      "type": "local",
      "command": ["npx", "-y", "@tokenlabai/mcp-server@0.6.48"],
      "environment": {
        "TOKENLAB_MCP_TOOL_PROFILE": "core",
        "TOKENLAB_API_KEY": "{env:TOKENLAB_API_KEY}"
      },
      "timeout": 30000
    }
  }
}

Le timeout plus long donne à npx le temps de télécharger le package lors du premier démarrage. Exécutez opencode mcp list avec le même OPENCODE_CONFIG et vérifiez que tokenlab est connecté. Ensuite, essayez :

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video renvoie un ID de tâche. L'agent appelle get_task_status jusqu'à ce que la vidéo soit prête. Voir Serveurs MCP OpenCode pour d'autres paramètres.

Choisir un modèle

Copiez un ID de modèle de codage actuel depuis la page Modèles. Comparez les modèles sur votre propre dépôt avant de définir une valeur par défaut.

Commandes courantes

Analyser le code :

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "What does this function do?" < src/utils.ts

Générer du code :

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Create a REST API with Express"

Revoir les modifications :

git diff | OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Review these changes"

Corriger les erreurs :

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Fix the TypeScript errors in this project"

Commandes interactives

CommandeDescription
/helpAfficher les commandes disponibles
/modelsPasser à un modèle différent
/clearEffacer l'historique de la conversation
/exitQuitter OpenCode

Dépannage

Conseils

Sur cette page