Responses

L’interface Responses convient aux clients, agents de codage et frameworks d’application de nouvelle génération qui utilisent le protocole OpenAI Responses. Elle est généralement utilisée lorsque l’on a besoin d’une structure d’entrée unifiée, d’appels d’outils, de contrôle de raisonnement ou de réponses plus complexes.

Endpoint

POST /v1/responses

Adresse complète :

https://www.routeapi.ai/v1/responses

Exemple de requête

curl https://www.routeapi.ai/v1/responses \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "input": "Explique les principaux usages de RouteAPI"
  }'

Paramètres courants

Champ	Type	Obligatoire	Description
model	string	Oui	ID de modèle
input	string/array	Oui	Contenu d’entrée
instructions	string	Non	Instructions de niveau système
stream	boolean	Non	Active ou non la sortie en streaming
tools	array	Non	Définitions d’outils
tool_choice	string/object	Non	Stratégie de sélection d’outil
temperature	number	Non	Température d’échantillonnage
max_output_tokens	number	Non	Nombre maximal de tokens en sortie

Différences avec Chat Completions

Élément	Chat Completions	Responses
Structure d’entrée	messages	input + instructions
Compatibilité	Le plus compatible avec les clients OpenAI SDK traditionnels	Plus courant dans les clients de nouveau protocole et les agents de codage
Appels d’outils	Pris en charge selon le modèle choisi	Pris en charge, avec une expression souvent plus riche
Scénarios recommandés	Chat général, intégration compatible	Nouveaux projets, agents de codage, tâches complexes

Recommandations d’intégration

• Si le client exige explicitement le protocole OpenAI Responses, utilisez /v1/responses.
• Si le client ne prend en charge que l’ancien Chat Completions OpenAI, utilisez /v1/chat/completions.
• La prise en charge de Responses par un même modèle dépend de la configuration des modèles RouteAPI et des capacités du service.