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_. Copiez-la maintenant; vous ne la reverrez plus. - 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.
Ce qui fonctionne dans Cursor
La documentation de Cursor indique que votre propre clé API ne fonctionne qu'avec les modèles de clavardage. Utilisez les modèles d'Inférence Nordique dans le clavardage de Cursor, en mode Ask. La complétion Tab et les modèles propres à Cursor, comme Composer, continuent d'utiliser Cursor et ne passent pas par Inférence Nordique. Si le mode Agent indique que le modèle ne prend pas en charge les clés API personnalisées, passez en mode Ask.
Cursor fait aussi passer chaque requête par ses propres serveurs avant qu'elle n'atteigne Inférence Nordique, et la politique de Zero Data Retention de Cursor ne s'applique pas quand vous utilisez votre propre clé. La résidence des données et les registres de possession d'Inférence Nordique commencent au moment où la requête atteint Inférence Nordique. Si votre équipe a besoin que tout le parcours soit couvert, utilisez un outil qui se connecte directement à Inférence Nordique, comme Claude Code ou Continue.
Configurer Cursor
- Ouvrez Cursor Settings et allez à Models.
- Dans la section API Keys, activez OpenAI API Key et collez votre clé
ni_live_. - Activez Override OpenAI Base URL et saisissez
https://northerninference.ca/v1. - Cliquez sur Save.
- Dans la liste des modèles de la même page, ajoutez un modèle nommé
claude-sonnet-4-6-t4et activez-le. - Ouvrez un clavardage en mode Ask, choisissez
claude-sonnet-4-6-t4dans le sélecteur de modèle et envoyez un message. - Vérifiez que la requête apparaît dans le portail sous Utilisation en quelques secondes.
Quelques bons modèles à ajouter :
claude-sonnet-4-6-t4
claude-opus-4-8-t4
claude-haiku-4-5-20251001-t4
gpt-4.1-mini-t3
mistral-large-2402-t3
llama3-70b-instruct-t3
Les noms qui se terminent par -t3 s'exécutent au Canada. Consultez la page Modèles pour voir chaque modèle et son prix.
Choisissez le modèle que vous avez ajouté, pas celui intégré à Cursor
L'URL de base que vous avez définie ne s'applique qu'aux modèles que Cursor considère comme des modèles OpenAI. Si vous choisissez l'une des entrées intégrées de Cursor, comme « Claude Sonnet » ou « Gemini », Cursor appelle directement cette entreprise et la requête n'atteint jamais Inférence Nordique. Choisissez toujours le nom exact que vous avez ajouté, par exemple claude-sonnet-4-6-t4.
Revenir aux modèles propres à Cursor
Tant que OpenAI API Key est activé, Cursor joint votre clé d'Inférence Nordique à ses requêtes. Pour utiliser de nouveau les modèles propres à Cursor, désactivez OpenAI API Key dans Cursor Settings, sous Models.
Images
Cursor détermine lui-même quels modèles peuvent traiter des images, d'après le nom du modèle. Il peut ne pas reconnaître un nom d'Inférence Nordique comme claude-sonnet-4-6-t4 comme capable de lire des images, et n'envoie alors que votre texte. Si Cursor affiche un paramètre pour autoriser les images avec un modèle personnalisé, activez-le. Vision et capacités indique quels modèles acceptent les images.
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 dans le clavardage pour lister les modèles que votre clé peut appeler.
Dépannage
| Ce que vous voyez | Ce qu'il faut faire |
|---|---|
| Les requêtes n'apparaissent pas dans Utilisation | Vous avez choisi l'un des modèles intégrés de Cursor. Choisissez plutôt le nom que vous avez ajouté. |
| « This model does not support custom API keys » | Vous êtes en mode Agent ou vous utilisez un modèle Cursor. Passez en mode Ask et choisissez votre modèle d'Inférence Nordique. |
| « Invalid API key », ou 401 | Vérifiez la clé dans Cursor Settings, sous Models, puis quittez et rouvrez Cursor, qui peut conserver une ancienne clé. |
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 dans le clavardage. |
| La première réponse après une pause est lente | C'est le temps de démarrage normal chez le fournisseur. Les réponses suivantes sont plus rapides. |
Facultatif
- Dépense par projet : créez une clé distincte pour chaque projet et définissez Dépense maximale par jour à sa création.
- Vos propres clés de fournisseur : activez BYOK sur la clé pour utiliser vos propres clés OpenAI ou Anthropic moyennant des frais d'acheminement seulement, moins élevés.