Codes d'état

Les points de terminaison renvoient des codes d'état HTTP appropriés en fonction du succès ou de l'échec de la requête dans la ligne d'état HTTP (par ex. HTTP/1.1 200 OK ou HTTP/1.1 400 Bad Request). Les codes d'état courants sont :

• 200 : Succès
• 400 : Requête incorrecte (paramètres manquants, JSON invalide, etc.)
• 404 : Non trouvé (le modèle n'existe pas, etc.)
• 429 : Trop de requêtes (par ex. lorsqu'une limite de débit est dépassée)
• 500 : Erreur interne du serveur
• 502 : Mauvaise passerelle (par ex. lorsqu'un modèle cloud ne peut pas être joint)

Messages d'erreur

Les erreurs sont renvoyées au format application/json avec la structure suivante, le message d'erreur se trouvant dans la propriété error :

{
  "error": "the model failed to generate a response"
}

Erreurs survenant pendant le streaming

Si une erreur survient en cours de streaming, l'erreur sera renvoyée sous forme d'objet au format application/x-ndjson avec une propriété error. Comme la réponse a déjà commencé, le code d'état de la réponse ne sera pas modifié.

{"model":"gemma4","created_at":"2025-10-26T17:21:21.196249Z","response":" Yes","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:21:21.207235Z","response":".","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:21:21.219166Z","response":"I","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:21:21.231094Z","response":"can","done":false}
{"error":"an error was encountered while running the model"}