OpenCode

Configurer l’API tierce OpenCode dans Fast-Token

OpenCode est un assistant de programmation IA open source qui permet une intégration API très personnalisable. En configurant une API tierce, vous pouvez choisir librement des modèles plus performants ou plus économiques (comme DeepSeek, SiliconFlow, etc.).

Étape 1 : Rassembler les informations API essentielles

Avant la configuration, préparez :

1. API Key : votre clé d’autorisation. Plateforme Fast-Token
2. Base URL : adresse du point de terminaison (par exemple https://fast-token.com/v1).
3. Model ID : nom du modèle (par exemple deepseek-ai/DeepSeek-V3).

Étape 2 : Ouvrir l’écran de configuration

1. Lancez OpenCode.
2. Cliquez sur l’icône engrenage en bas à gauche -> Settings.
3. Dans la zone de recherche, saisissez OpenCode ou AI Provider.
4. Dans la liste Provider, choisissez OpenAI Compatible (ou Custom).

Étape 3 : Renseigner les paramètres

1. Définir la Base URL

Dans OpenAI Compatible: Base URL, saisissez l’adresse de votre proxy tiers.

Attention : l’adresse doit se terminer par /v1 et ne doit pas inclure /chat/completions.

2. Associer la clé API

Dans OpenAI Compatible: API Key, collez votre clé.

3. Définir la liste des modèles

Ouvrez Custom Models ou Model Map :

• Cliquez sur Add Item.
• Saisissez le nom affiché dans l’interface (par exemple DeepSeek).
• Saisissez l’ID réel du modèle chez le fournisseur API (par exemple deepseek-chat).

Étape 4 : Activer et tester

1. Ouvrez la fenêtre Chat d’OpenCode (généralement l’icône robot dans la barre latérale).
2. Dans le sélecteur de modèle en bas, choisissez le Custom Model que vous venez d’ajouter.
3. Envoyez une instruction pour tester la connexion (par exemple : écris un tri rapide).

Avancé : variables d’environnement (pour les développeurs)

Si vous préférez gérer la configuration via le terminal ou l’environnement système, OpenCode lit aussi les fichiers .env et les variables d’environnement. Vous pouvez définir :

• OPENAI_API_BASE : votre URL tierce
• OPENAI_API_KEY : votre clé

Dépannage

Message d’erreur	Cause possible	Solution
Model Not Found	ID de modèle incorrect	Vérifiez la liste des modèles chez le fournisseur et assurez-vous que l’ID correspond exactement.
Invalid API Key	Clé expirée ou mal copiée	Régénérez la clé et vérifiez qu’il n’y a pas de retours à la ligne en trop.
Network Error	Problème de certificat ou de proxy	Avec un relais domestique, vérifiez s’il faut activer ou désactiver un proxy réseau spécifique.
Stream Mode Error	API sans sortie en flux	Essayez de désactiver Enable Streaming dans les paramètres (la plupart des API modernes le supportent).

Conseil : OpenCode convient bien aux modèles open source. Si vous exécutez LM Studio ou LocalAI en local, pointez la Base URL vers http://localhost:xxxx/v1 pour une assistance au code entièrement hors ligne.