Skip to main content
NexusAPI fonctionne avec les clients IA courants et les API de style OpenAI. Chaque outil peut compléter lui-même une partie du chemin : renseignez donc l’adresse correspondant à votre usage et ne recopiez pas la configuration complète d’un outil dans un autre.

​
Préparer l’intégration

Avant toute méthode d’intégration, vérifiez les points suivants :
  1. Une clé API a été créée dans la console.
  2. Le groupe de cette clé donne accès au modèle visé.
  3. L’identifiant exact du modèle a été copié depuis le catalogue de modèles.
  4. Le protocole pris en charge par le modèle a été vérifié, puis la requête est envoyée via HTTPS.

​
Cas d’utilisation courants

​
URL et protocoles

Ce tableau sert à choisir l’intégration. Consultez d’abord la matrice des capacités API et modèles pour confirmer le modèle et le protocole, puis Chat Completions pour les paramètres et la structure de réponse. La disponibilité réelle pour une clé et un modèle reste celle affichée dans le catalogue de modèles.

​
Choisir d’abord le bon protocole

Un même Base URL ne signifie pas que chaque modèle accepte tous les formats de requête.
N’utilisez pas Responses comme endpoint de remplacement universelSi supported_endpoint_types d’un modèle ne contient pas openai-response et que /v1/responses renvoie status_code=500, not implemented, le protocole ne correspond pas. Utilisez un endpoint indiqué pour ce modèle ; conservez la configuration Messages native de Claude Code. Réessayer la même requête ne corrige pas une incompatibilité de protocole.

​
Pourquoi les URL peuvent être différentes

Les requêtes OpenAI génériques utilisent généralement :
Certains clients demandent l’URL du site sans /v1, ou ajoutent automatiquement /chat/completions, /responses ou /messages. Suivez le guide de l’outil concerné ; pour les images, utilisez le guide des modèles d’image.
Évitez les chemins dupliquésSi le client ajoute déjà /v1, le saisir vous-même peut former /v1/v1/... et provoquer une erreur 404. En cas de 404, vérifiez d’abord l’URL réellement envoyée par le client.

​
Ne mélangez pas la configuration d’un client et l’API générique

Les outils CLI, extensions d’éditeur et applications maison peuvent utiliser des protocoles et fichiers de configuration distincts. Même avec le même nom de modèle, ne copiez pas une configuration complète d’un outil dans un autre.
  • Codex CLI : suivez le guide Codex CLI et sa configuration Responses.
  • Claude Code : suivez le guide Claude Code et gardez sa configuration Anthropic Messages native.
  • Application texte maison : commencez par Chat Completions, sauf si le SDK exige explicitement un autre protocole.
  • Images : utilisez le point de terminaison d’image, sans envoyer ses paramètres à une route de chat texte.
  • En cas de doute : identifiez le client exact et inspectez le chemin réellement envoyé avant de modifier les réglages.

​
Référence API

Consultez la matrice des capacités API et modèles pour valider le protocole du modèle ciblé. La requête minimale Chat Completions est décrite dans Chat Completions. Ce centre d’aide explique comment choisir et configurer une intégration, avec des requêtes minimales vérifiables. Les paramètres optionnels dépendent toujours du protocole du client et des capacités actuellement affichées dans le catalogue de modèles.

​
Vérifier que la configuration fonctionne

  • Le client renvoie une réponse complète.
  • La requête correspondante apparaît dans le journal d’utilisation de la console.
  • Le modèle, le groupe et le montant facturé correspondent à ce qui est attendu.
En cas d’échec, conservez le message d’erreur et le Request ID, puis suivez le guide d’auto-diagnostic.