POSTOpenAI
/chat/completionsCréer une complétion de chat
Crée une réponse de modèle à partir de l'historique de conversation, avec streaming, outils et comptabilisation de l'utilisation.
Authentification
Utilisez votre clé API avec Authorization: Bearer sk-xxxx.
Authorization: Bearer sk-xxxx
Type de contenu
application/json
Exemples de modèles
gpt-4o, gpt-4.1, gpt-5, o3, o4-mini
Exemple de requête
{
"model": "gpt-4o",
"messages": [
{
"role": "user",
"content": "Hello"
}
],
"stream": false
}Exemple de réponse
{
"id": "chatcmpl_xxx",
"object": "chat.completion",
"created": 0,
"model": "gpt-4o",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello!"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 8,
"completion_tokens": 3,
"total_tokens": 11
}
}curl Example
curl -X POST 'https://costrouter.ai/v1/chat/completions' \
-H 'Authorization: Bearer sk-xxxx'
-H 'Content-Type: application/json'
-d '{
"model": "gpt-4o",
"messages": [
{
"role": "user",
"content": "Hello"
}
],
"stream": false
}'Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| model | string | Oui | ID du modèle. Le CostRouter sélectionne un canal disponible selon le nom du modèle et transfère la requête. |
| messages | array<object> | Oui | Tableau de messages de conversation, généralement avec les rôles system, user, assistant ou tool. |
| temperature | number | Non | Température d'échantillonnage. Des valeurs plus élevées rendent la sortie plus aléatoire. |
| top_p | number | Non | Paramètre d'échantillonnage nucleus, généralement ajusté à la place de temperature. |
| stream | boolean | Non | Indique s'il faut retourner une réponse en streaming. |
| max_tokens | integer | Non | Nombre maximal de tokens de sortie. |
| tools | array<object> | Non | Définitions d'outils ou de fonctions. La prise en charge dépend du modèle en amont. |
| response_format | object | Non | Format de réponse structurée. La prise en charge dépend du modèle en amont. |
Exemple de réponse
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| id | string | Non | ID de réponse, de tâche ou de ressource. |
| object | string | Non | Type d'objet de réponse. |
| created | integer | Non | Horodatage de création. |
| model | string | Non | - |
| choices | array<object> | Non | Sorties candidates du modèle. |
| usage | object | Non | Statistiques d'utilisation des tokens. |