OpenCode | Documentation d'Inférence Nordique

Utilisez Inférence Nordique comme dorsale OpenCode avec des routes canadiennes souveraines exactes et des registres de possession par requête pour les équipes gouvernementales et réglementées.

Inférence Nordique est une API d'IA souveraine canadienne pour les équipes du gouvernement, de la défense, de la santé et des secteurs réglementés, y compris les organisations relevant du Programme des marchandises contrôlées. Chaque route comporte une résidence des données au Canada conforme à la LPRPDE, un chemin exact vers les derniers modèles de pointe et à poids ouverts, ainsi qu'un registre de chaîne de possession par requête.

Avant de commencer

Créez une clé API. Dans le portail, ouvrez Clés API et cliquez sur Créer la clé. Votre clé commence par ni_live_.
Ajoutez des crédits. Les nouveaux comptes démarrent avec un solde de 0 $, et chaque requête est refusée tant que vous n'ajoutez pas de crédits. Ouvrez Facturation et cliquez sur Acheter des crédits.
Choisissez un modèle. Les noms de modèles d'Inférence Nordique se terminent par une étiquette de niveau, par exemple claude-sonnet-4-6-t4. Vous les trouverez tous sur la page Modèles.

Configurer OpenCode

1. Ajoutez Inférence Nordique à votre configuration OpenCode. Créez un fichier nommé opencode.json dans le dossier de votre projet et collez-y ce qui suit. Cela fonctionne sur tous les systèmes d'exploitation. Pour l'utiliser dans tous vos projets, placez-le plutôt dans ~/.config/opencode/opencode.json sur Mac et Linux, ou dans C:\Users\you\.config\opencode\opencode.json sous Windows.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "northerninference/claude-sonnet-4-6-t4",
  "small_model": "northerninference/claude-haiku-4-5-20251001-t4",
  "provider": {
    "northerninference": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Northern Inference",
      "options": { "baseURL": "https://northerninference.ca/v1" },
      "models": {
        "claude-sonnet-4-6-t4": { "name": "Claude Sonnet 4.6" },
        "claude-haiku-4-5-20251001-t4": { "name": "Claude Haiku 4.5" }
      }
    }
  }
}

model est le modèle avec lequel OpenCode démarre. small_model est le modèle qu'il utilise pour les petites tâches d'arrière-plan, comme nommer vos sessions. Définir les deux garde toutes les requêtes sur Inférence Nordique.

2. Ajoutez votre clé. Exécutez opencode auth login, choisissez Other, saisissez l'identifiant de fournisseur northerninference et collez votre clé ni_live_. OpenCode l'enregistre pour vous, vous n'avez donc aucune variable d'environnement à définir.

3. Redémarrez OpenCode et envoyez un message. Il apparaît dans le portail sous Utilisation en quelques secondes.

Ajouter d'autres modèles

Chaque nom sous models est envoyé tel quel à Inférence Nordique : il doit donc correspondre à un nom de la page Modèles, y compris la casse. Le "name" à côté n'est que l'étiquette qu'OpenCode vous montre. Les noms se terminant par -t3 fonctionnent au Canada, par exemple mistral-large-2402-t3.

OpenCode lit opencode.json au démarrage ; redémarrez-le donc après une modification.

Si un nom de modèle n'est pas reconnu

Inférence Nordique répond par un HTTP 404 et Model 'X' is not a route this key can call. Elle ne remplace jamais le modèle par un autre. Utilisez un nom de la page Modèles, ou tapez ni-models comme message de clavardage pour lister les modèles que votre clé peut appeler. Ces commandes ni- répondent immédiatement et ne sont pas facturées.

Dépannage

Ce que vous voyez	Ce qu'il faut faire
Inférence Nordique est absente du sélecteur de modèles	Vérifiez que `opencode.json` est du JSON valide et se trouve dans le dossier d'où vous lancez OpenCode, puis redémarrez OpenCode.
401	La clé est incorrecte ou manquante. Relancez `opencode auth login` pour `northerninference`.
402 `Insufficient credits. Add credits in the portal under Billing (https://northerninference.ca/portal/?page=billing) to continue.`	Ajoutez des crédits dans le portail, sous Facturation.
404 `Model 'X' is not a route this key can call.`	Utilisez un nom de la page Modèles, ou tapez `ni-models`.

Limites de dépense

OpenCode peut faire de nombreuses requêtes dans une même tâche. Pour plafonner les dépenses, créez une clé distincte dans le portail sous Clés API, définissez une limite de dépense quotidienne à sa création, et utilisez cette clé dans OpenCode.