Créer une réponse Chat Completions

Crée une réponse du modèle à partir de l’historique de la conversation. Prend en charge les réponses en streaming et hors streaming. Compatible avec l’API OpenAI Chat Completions.

POST /v1/chat/completions

Racine du service: https://getrouter.ai

Protocole: OpenAI Chat Completions

Authentification: Authorization: Bearer YOUR_API_KEY

Corps de la requête

Le corps de la requête est obligatoire. Type de média: application/json

Champs de la requête

Champ	Type	Obligatoire	Description
`model`	`string`	Oui	ID du modèle
`messages`	`array<object>`	Oui	Liste des messages de la conversation
`temperature`	`number`	Non	Température d’échantillonnage Valeur par défaut: `1`; Plage: 0–2
`top_p`	`number`	Non	Paramètre d’échantillonnage nucleus Valeur par défaut: `1`; Plage: 0–1
`n`	`integer`	Non	Nombre de générations Valeur par défaut: `1`; Plage: 1–∞
`stream`	`boolean`	Non	Indique si la réponse est diffusée en streaming Valeur par défaut: `false`
`stream_options`	`object`	Non	—
`stop`	`string or array<string>`	Non	Séquences d’arrêt
`max_tokens`	`integer`	Non	Nombre maximal de tokens générés
`max_completion_tokens`	`integer`	Non	Nombre maximal de tokens de complétion
`presence_penalty`	`number`	Non	Valeur par défaut: `0`; Plage: -2–2
`frequency_penalty`	`number`	Non	Valeur par défaut: `0`; Plage: -2–2
`logit_bias`	`object`	Non	—
`user`	`string`	Non	—
`tools`	`array<object>`	Non	—
`tool_choice`	`string or object`	Non	—
`response_format`	`object`	Non	—
`seed`	`integer`	Non	—
`reasoning_effort`	`string`	Non	Niveau d’effort de raisonnement (pour les modèles compatibles) Valeurs autorisées: `low`, `medium`, `high`
`modalities`	`array<string>`	Non	—
`audio`	`object`	Non	—

Exemple de requête

curl --request POST \
  --url https://getrouter.ai/v1/chat/completions \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "MODEL_ID",
  "messages": [
    {
      "role": "system",
      "content": "Bonjour, présentez-vous."
    }
  ],
  "stream": false,
  "temperature": 1,
  "max_tokens": 1
}'

Réponses

Statut	Description
`200`	Réponse créée
`400`	Paramètres de requête incorrects
`429`	Limite de fréquence atteinte

Champs d’une réponse réussie

Champ	Type	Obligatoire	Description
`id`	`string`	Non	—
`object`	`string`	Non	—
`created`	`integer`	Non	—
`model`	`string`	Non	—
`choices`	`array<object>`	Non	—
`usage`	`object`	Non	—
`system_fingerprint`	`string`	Non	—

Exemple de réponse

{
  "id": "string",
  "object": "object",
  "created": 1,
  "model": "MODEL_ID",
  "choices": [
    {
      "index": 1,
      "message": {
        "role": "system",
        "content": "Bonjour, présentez-vous.",
        "name": "string",
        "tool_calls": [
          {
            "id": null,
            "type": null,
            "function": null
          }
        ],
        "tool_call_id": "string",
        "reasoning_content": "string"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 1,
    "prompt_tokens_details": {
      "cached_tokens": 1,
      "text_tokens": 1,
      "audio_tokens": 1,
      "image_tokens": 1
    },
    "completion_tokens_details": {
      "text_tokens": 1,
      "audio_tokens": 1,
      "reasoning_tokens": 1
    }
  },
  "system_fingerprint": "string"
}

Guide associé

Pour les flux de travail et exemples complets, consultez le guide de l’API Chat Completions.

Cette page est générée à partir de la spécification OpenAPI Relay publique. Consultez la spécification complète dans l’API Explorer.

#Créer une réponse Chat Completions

#Corps de la requête

#Champs de la requête

#Exemple de requête

#Réponses

#Champs d’une réponse réussie

#Exemple de réponse

#Guide associé