Accueil / Guides / Utiliser OpenCode avec une API LLM gratuite

Utiliser OpenCode avec une API LLM gratuite

OpenCode est un agent de programmation open source pour le terminal et le bureau. Il accepte tout fournisseur compatible OpenAI. Ce guide connecte OpenCode à des modèles gratuits grâce à FreeLLMAPI. Une commande écrit la configuration et enregistre la clé.

Le code, les noms de modèles et les libellés du catalogue en direct sont affichés en anglais.

Étape 1 : installer FreeLLMAPI

FreeLLMAPI est une passerelle open source. Elle s'exécute sur votre ordinateur dans Docker et regroupe les offres gratuites de 45 fournisseurs derrière une seule clé.

Installer sur macOS ou Linux

curl -fsSL https://freellmapi.co/install.sh | bash

Ouvrez http://localhost:3001. Ajoutez au moins deux clés de fournisseurs gratuits sur la page Keys. Google AI Studio et Groq fournissent chacun une clé gratuite en quelques minutes. Copiez votre clé unifiée depuis la même page.

Étape 2 : connecter OpenCode avec une commande

Une commande

npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencode

La commande effectue trois actions :

  • Elle ajoute un fournisseur freellmapi dans ~/.config/opencode/opencode.json. Le fournisseur liste les modèles de votre catalogue en direct avec leurs limites de contexte.
  • Elle définit freellmapi/auto comme modèle par défaut.
  • Elle enregistre la clé dans le fichier d'identifiants d'OpenCode, ~/.local/share/opencode/auth.json. Vous n'avez pas besoin de variable d'environnement, ni dans la CLI ni dans l'application de bureau.

La commande crée une sauvegarde avant d'écrire. Elle fusionne le nouveau fournisseur, donc vos autres fournisseurs restent en place. Si XDG_CONFIG_HOME ou XDG_DATA_HOME est défini, la commande utilise ces dossiers.

Avant de lancer une longue tâche, vérifiez que la passerelle peut répondre à une requête maintenant. Cet appel ne liste que les modèles qui ont une clé utilisable à ce moment :

Vérifier les modèles prêts

curl "http://localhost:3001/v1/models?execution_status=ready" \
  -H "Authorization: Bearer <unified-key>"

Un modèle au statut exhausted a des clés, mais toutes ont atteint une limite pour le moment. Ce statut disparaît à la fin des délais d'attente. Exécutez npx freellmapi doctor pour vérifier que les requêtes d'un client atteignent la passerelle. Le journal des requêtes du tableau de bord affiche chaque appel depuis OpenCode. L'en-tête de réponse X-Routed-Via indique le fournisseur et le modèle qui ont répondu à chaque requête. Si une requête a basculé, l'en-tête X-Fallback-Trail indique chaque saut en échec et la raison.

Configuration manuelle : le bloc de fournisseur opencode.json

Pour une configuration manuelle, ajoutez ce bloc dans ~/.config/opencode/opencode.json, ou dans opencode.json de votre projet. OpenCode utilise @ai-sdk/openai-compatible pour les points d'accès /v1/chat/completions.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "freellmapi/auto",
  "provider": {
    "freellmapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "FreeLLMAPI",
      "options": {
        "baseURL": "http://localhost:3001/v1"
      },
      "models": {
        "auto": {
          "name": "Auto",
          "limit": { "context": 128000, "output": 8192 }
        }
      }
    }
  }
}

Ajoutez ensuite la clé. Lancez OpenCode, exécutez /connect, sélectionnez le fournisseur freellmapi et collez votre clé unifiée. L'ID du fournisseur dans /connect doit correspondre à l'ID de la configuration. Exécutez /models pour sélectionner un modèle.

  • limit.context est le nombre maximal de tokens d'entrée du modèle. limit.output est le nombre maximal de tokens qu'il peut générer.
  • Le model de premier niveau utilise le format provider/model. Sans lui, OpenCode garde le modèle utilisé précédemment.
  • Chaque ID de modèle que vous voulez utiliser doit figurer dans la table models. Ajoutez d'autres ID issus de GET /v1/models.
Remarque sur les versions de configuration : la documentation d'OpenCode décrit désormais un format de configuration V2 avec une clé providers. Elle indique que le format V1 ci-dessus reste pris en charge. La commande d'installation de FreeLLMAPI écrit le format V1.

Choisir des modèles pour OpenCode

OpenCode est un agent. Il lit des fichiers, les modifie et exécute des commandes par des appels d'outils. Chaque requête contient un prompt système, des définitions d'outils et le contenu de fichiers. Utilisez des modèles avec appel d'outils et une grande fenêtre de contexte.

Modèles gratuits pour OpenCode : appel d'outils et contexte de 128K+
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
OuiNon
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
OuiOui
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaOuiOui
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceOuiNon
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditOuiOui
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditOuiOui
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/jour
50 req/day account-wide (1,000 after a $10 purchase)
OuiOui
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/jour
Shared rate limit
OuiNon
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/jour
70,000 jetons/min
~6M
OuiOui
Gemini 3.6 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayOuiOui

Affichage de 12 modèles gratuits sur 109 correspondants. Voir tous les modèles.

Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.

Utilisez freellmapi/auto pour laisser le routeur choisir un modèle pour chaque requête. Ajoutez auto:smart ou auto:fast à la table models pour orienter les requêtes selon l'intelligence ou la vitesse. Vous pouvez aussi ajouter un profil nommé, par exemple auto:coding, après l'avoir créé sur le tableau de bord.

Limites de débit et longues sessions

Une seule tâche d'agent peut envoyer des dizaines de requêtes. Une seule offre gratuite arrête vite une longue tâche. FreeLLMAPI compte les requêtes et les tokens de chaque clé. Lorsqu'un fournisseur renvoie une erreur 429, le routeur envoie la requête au modèle suivant de la chaîne, et la session continue.

  • Ajoutez des clés de quatre fournisseurs ou plus. Plus de fournisseurs donnent plus de requêtes par jour.
  • Activez le transfert de contexte avec FREELLMAPI_CONTEXT_HANDOFF=on_model_switch dans le fichier .env de FreeLLMAPI. Quand le modèle change, le modèle suivant reçoit une courte note indiquant qu'il poursuit une tâche.
  • Les sessions persistantes gardent une conversation sur un même modèle pendant 30 minutes. Cela maintient la cohérence de l'agent.
  • Démarrez une nouvelle session pour chaque tâche. Un contexte plus petit utilise moins de tokens par requête.

Dépannage

ProblèmeCauseSolution
"Invalid API key" avec une clé valideUne valeur apiKey vide dans la configuration remplace la clé de /connectSupprimez apiKey de options, ou relancez setup-opencode
OpenCode n'utilise pas le nouveau fournisseurLe model de premier niveau n'est pas définiDéfinissez "model": "freellmapi/auto"
Modèle introuvableL'ID du modèle ne figure pas dans la table models du fournisseurAjoutez l'ID à la table, ou relancez setup-opencode
La clé {env:VAR} est videOpenCode remplace une variable non définie par une chaîne videExportez la variable dans le même shell, ou enregistrez la clé avec /connect
Les appels d'outils échouentLe modèle gère mal l'appel d'outilsChoisissez un modèle du tableau ci-dessus
« Tous les modèles ont atteint leur limite après N tentatives »Toutes les clés ont atteint leur limiteAjoutez des clés d'autres fournisseurs, ou attendez la fin des délais d'attente
Utilisez chacun de ces modèles avec une seule clé. FreeLLMAPI est un routeur open source auto-hébergé. Il place toutes ces offres gratuites derrière un seul point de terminaison compatible OpenAI, et bascule vers une autre offre lorsqu'une limite de débit est atteinte. Parcourir le catalogue ou passer en production.

Questions fréquentes

Puis-je utiliser OpenCode gratuitement ?

Oui. OpenCode est open source. Connectez-le à FreeLLMAPI comme fournisseur compatible OpenAI. La passerelle envoie chaque requête vers les offres gratuites des fournisseurs, donc l'inférence coûte $0.

Comment ajouter un fournisseur personnalisé compatible OpenAI à OpenCode ?

Ajoutez à opencode.json un fournisseur avec npm défini sur @ai-sdk/openai-compatible, options.baseURL et une table models. Lancez ensuite /connect pour enregistrer la clé, puis /models pour sélectionner un modèle.

Quel modèle gratuit convient le mieux à OpenCode ?

Utilisez un modèle avec appel d'outils et au moins 128K de contexte. Le tableau de cette page présente les modèles gratuits les plus performants qui respectent aujourd'hui ces deux règles. Utilisez freellmapi/auto pour laisser le routeur en choisir un.

Où OpenCode stocke-t-il les clés d'API ?

Les clés ajoutées avec /connect sont enregistrées dans ~/.local/share/opencode/auth.json. La commande d'installation de FreeLLMAPI y écrit la clé, afin que la CLI et l'application de bureau la trouvent toutes deux.

Guides associés

Sources

Tous les guides · Parcourir tous les modèles gratuits