pi (pi-coding-agent) | Documentation Inférence Nordique

Utilisez Inférence Nordique avec l'agent de programmation pi sur des routes canadiennes souveraines exactes, 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.

Installer pi

Mac et Linux :

curl -fsSL https://pi.dev/install.sh | sh

Windows PowerShell :

powershell -c "irm https://pi.dev/install.ps1 | iex"

Les installateurs configurent aussi Node.js si vous en avez besoin. Si vous préférez npm, exécutez npm install -g --ignore-scripts @earendil-works/pi-coding-agent (Node.js 22.19 ou plus récent). L'ancien paquet @mariozechner/pi-coding-agent est obsolète.

Connecter pi à Inférence Nordique

Créez le fichier ~/.pi/agent/models.json (sous Windows, C:\Users\you\.pi\agent\models.json) et collez ceci, en remplaçant ni_live_YOUR_KEY_HERE par votre clé :

{
  "providers": {
    "northerninference": {
      "baseUrl": "https://northerninference.ca/v1",
      "api": "openai-completions",
      "apiKey": "ni_live_YOUR_KEY_HERE",
      "models": [
        { "id": "claude-sonnet-4-6-t4" },
        { "id": "DeepSeek-V4-Flash-t4" }
      ]
    }
  }
}

Démarrez pi, tapez /model, choisissez un modèle sous northerninference et appuyez sur Ctrl+S pour en faire le modèle par défaut des nouvelles sessions. Envoyez un message. Il apparaît dans le portail sous Utilisation en quelques secondes.

Chaque id est envoyé tel quel à Inférence Nordique : il doit donc correspondre à un nom de la page Modèles, y compris la casse. Pour ajouter un modèle, ajoutez une autre ligne { "id": "..." }.

Assurez-vous d'utiliser Inférence Nordique

Dans /model, choisissez toujours une entrée sous northerninference. Si vous vous êtes aussi connecté à un autre fournisseur dans pi, ses modèles apparaissent dans la même liste, et en choisir un envoie votre requête à ce fournisseur.

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 pour lister les modèles que votre clé peut appeler.

Dépannage

Ce que vous voyez	Ce qu'il faut faire
Vos modèles d'Inférence Nordique sont absents de `/model`	pi n'affiche un modèle que s'il peut lire sa clé. Vérifiez que `models.json` est du JSON valide (guillemets, virgules, accolades) et que le champ s'écrit `apiKey`.
401	La clé est incorrecte ou a été révoquée. Collez-la de nouveau, sans guillemets ni espaces superflus.
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.
403 `privacy_tier_not_allowed`	Votre clé est limitée à certains niveaux, et ce modèle se trouve dans un autre. Choisissez un modèle que votre clé autorise, ou modifiez les niveaux autorisés de la clé dans le portail sous Clés API.
400 `ambiguous_model_route`	Le nom désigne le même modèle sur plus d'une route que votre clé peut appeler. Utilisez l'un des noms de route que le message énumère.
404 `Model 'X' is not a route this key can call.`	Utilisez un nom de la page Modèles, ou tapez `ni-models`.

Gardez votre clé en sécurité

Si votre clé a été collée dans un clavardage, une capture d'écran ou un écran partagé, révoquez-la dans le portail sous Clés API, créez-en une nouvelle et mettez-la dans models.json.