Référence API

Chat Completions

POST/v1/chat/completions

L'endpoint principal : chat multitour, streaming, appel d'outils, vision et mode JSON pour chaque modèle de chat du catalogue.

#Paramètres de la requête

  • modelstringobligatoire

    ID de modèle issu de /v1/models. La passerelle en déduit le fournisseur en amont.

  • messagesarrayobligatoire

    Tours de conversation : {role: system|user|assistant|tool, content}. content peut être une chaîne ou un tableau de parties multimodales.

  • streambooleanfacultatif

    true diffuse des deltas SSE, terminés par data: [DONE].

  • temperaturenumberfacultatif

    De 0 à 2. Laissez vide pour la valeur par défaut du modèle.

  • max_tokensintegerfacultatif

    Limite supérieure de tokens générés ; plafonne aussi l'estimation du quota préréservé.

  • toolsarrayfacultatif

    Déclarations de fonctions que le modèle peut appeler — voir le guide sur l'appel d'outils.

  • tool_choicestring | objectfacultatif

    "auto", "none", ou imposez une fonction précise.

  • response_formatobjectfacultatif

    {"type":"json_object"} ou un wrapper json_schema pour une sortie structurée sur les modèles compatibles.

  • top_pnumberfacultatif

    Échantillonnage nucleus ; utilisez temperature ou top_p, pas les deux.

  • stopstring | arrayfacultatif

    Jusqu'à 4 séquences d'arrêt qui interrompent la génération.

#Erreurs associées

  • 400 invalid_request_errorCorps mal formé ou paramètre non pris en charge par ce modèle.
  • 401Jeton bearer invalide ou manquant. Pas de error.code sur ce chemin — basez-vous sur le statut.
  • 402 insufficient_user_quotaLe solde du portefeuille ne couvre pas l'estimation préréservée.
  • 429Limitation par clé. Corps vide ; attendez Retry-After. Un 429 qui contient insufficient_user_quota correspond en revanche à un plafond de dépenses quotidien.
  • 503 model_not_foundModèle inconnu, ou aucun canal opérationnel ne le sert actuellement.

Table complète des codes d'erreur →

#Exemple de requête

curl https://www.aisplice.store/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "messages": [{"role": "user", "content": "Say hello."}]
  }'

#Réponse

response.json
{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "gpt-5.6-luna",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "Hello!"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 9, "completion_tokens": 3, "total_tokens": 12}
}

Toujours bloqué ?

Envoyez-nous l'ID de requête ou le message d'erreur, et nous examinerons le problème.