API Responses et Codex - NexusAPI 文档中心

/v1/responses n’est pas une « nouvelle API de chat » universelle. Dans NexusAPI, il sert surtout au Provider personnalisé configuré dans le guide Codex CLI, ou à un modèle, groupe de clé et canal explicitement confirmés pour le protocole Responses.

Confirmez le modèle et le canal d’abordN’utilisez pas /v1/responses pour les canaux Claude actuels de type Anthropic. En cas de status_code=500, not implemented, utilisez Chat Completions, ou la configuration native Messages de Claude Code.

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 confirmé pour Responses	Utilisez son client ou schéma Responses et vérifiez d’abord une requête minimale
Application texte OpenAI générique	Utilisez Chat Completions ; ne basculez pas uniquement parce que cette API est plus récente
Claude de type Anthropic	Utilisez Messages ou Chat Completions, pas cet endpoint

Requête minimale de vérification

Uniquement après confirmation du modèle et du canal :

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 la référence API Apifox ou 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/....
Le modèle prend explicitement en charge Responses ; utilisez un autre protocole pour Claude Anthropic.
Conservez le Request ID, la version du client et l’erreur complète, puis suivez l’auto-vérification.