Chat Completions

Chat Completions est l’interface de conversation la plus courante. Elle convient au chat général, aux assistants de programmation, aux résumés, à la classification, aux appels d’outils et aux conversations multi-tours.

Endpoint

POST /v1/chat/completions

Adresse complète :

https://www.routeapi.ai/v1/chat/completions

Exemple de requête

curl https://www.routeapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      { "role": "user", "content": "Présente RouteAPI en une phrase" }
    ]
  }'

Paramètres de requête

Champ	Type	Obligatoire	Description
model	string	Oui	ID de modèle, qui doit être disponible pour le compte actuel
messages	array	Oui	Liste des messages de conversation
stream	boolean	Non	Active ou non la sortie SSE en streaming
temperature	number	Non	Température d’échantillonnage
top_p	number	Non	Paramètre nucleus sampling
max_tokens	number	Non	Nombre maximal de tokens en sortie
tools	array	Non	Définitions d’outils
tool_choice	string/object	Non	Stratégie de sélection d’outil
response_format	object	Non	JSON mode ou JSON Schema
stream_options	object	Non	Options supplémentaires pour la sortie en streaming

Format de messages

[
  { "role": "system", "content": "Tu es un assistant technique rigoureux." },
  { "role": "user", "content": "Explique ce qu'est une passerelle API." }
]

Rôles courants :

Role	Description
system	Prompt système
user	Entrée utilisateur
assistant	Réponse historique du modèle
tool	Résultat d’appel d’outil

Exemple de réponse

{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "created": 1730000000,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "RouteAPI est une passerelle API qui unifie la gestion de plusieurs services de modèles d'IA."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 18,
    "total_tokens": 42
  }
}

Notes de compatibilité

• La prise en charge d’un même paramètre peut varier selon les services de modèles.
• Si la requête contient des paramètres optionnels comme tools, response_format ou stream_options, vérifiez d’abord que le modèle choisi prend en charge la capacité correspondante.
• Les paramètres optionnels transmis explicitement avec 0 ou false doivent être considérés comme définis par l’utilisateur.