API Responses et Codex - NexusAPI

Dans NexusAPI, /v1/responses sert au Provider personnalisé configuré dans le guide Codex CLI, ou à un modèle dont supported_endpoint_types dans /v1/models contient openai-response.

Quand utiliser ResponsesUtilisez /v1/responses uniquement lorsque supported_endpoint_types contient openai-response. En cas de status_code=500, not implemented, utilisez le protocole indiqué pour ce modèle : ce n’est généralement pas une erreur temporaire à réessayer.

Endpoint et périmètre

POST https://nexusapi.link/v1/responses

Situation	Approche recommandée
Codex CLI	Utilisez la configuration Provider `wire_api = "responses"` du guide Codex CLI
Autre application avec modèle dont `supported_endpoint_types` contient `openai-response`	Utilisez son client ou schéma Responses et vérifiez d’abord une requête minimale
Application texte OpenAI générique	Préférez Chat Completions
Modèle sans `openai-response`	Utilisez le protocole Chat Completions ou Messages indiqué dans `supported_endpoint_types`, pas cet endpoint

Requête minimale de vérification

Uniquement après confirmation du modèle :

curl 'https://nexusapi.link/v1/responses' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "YOUR_RESPONSES_MODEL_ID",
    "input": "Répondez seulement : connexion réussie"
  }'

input n’est pas le champ messages de Chat Completions et la réponse ne doit pas être lue comme choices[0].message. Consultez le schéma officiel de votre client pour les champs complets, événements de streaming et résultat.

Points clés de la configuration Codex CLI

model_provider = "nexusapi"
model = "YOUR_MODEL_ID"

[model_providers.nexusapi]
base_url = "https://nexusapi.link/v1"
env_key = "NEXUSAPI_API_KEY"
wire_api = "responses"

Conservez la clé dans la variable NEXUSAPI_API_KEY, jamais dans config.toml ou auth.json. Le guide Codex CLI couvre l’installation, les variables par système et la vérification.

Premiers contrôles

Le groupe de la clé contient le modèle et son ID correspond exactement au catalogue.
Le client envoie bien /v1/responses, pas /v1/v1/....
supported_endpoint_types du modèle contient openai-response ; sinon, utilisez le protocole correspondant indiqué.
Conservez le Request ID, la version du client et l’erreur complète, puis suivez l’auto-vérification.