أكواد الحالة

تُرجع نقاط النهاية أكواد حالة HTTP المناسبة بناءً على نجاح أو فشل الطلب في سطر حالة HTTP (مثل HTTP/1.1 200 OK أو HTTP/1.1 400 Bad Request). الأكواد الشائعة هي:

• 200: نجاح
• 400: طلب غير صالح (معلمات مفقودة، JSON غير صالح، إلخ)
• 404: غير موجود (النموذج غير موجود، إلخ)
• 429: طلبات كثيرة جدًا (مثلما عند تجاوز حد المعدل)
• 500: خطأ داخلي في الخادم
• 502: بوابة غير صالحة (مثلما عندما يتعذر الوصول إلى نموذج سحابي)

رسائل الخطأ

يتم إرجاع الأخطاء بتنسيق application/json مع الهيكل التالي، حيث توجد رسالة الخطأ في الحقل error:

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

الأخطاء التي تحدث أثناء البث المتتابع

إذا حدث خطأ في منتصف البث المتتابع، سيتم إرجاع الخطأ ككائن بتنسيق application/x-ndjson مع حقل error. ونظرًا لأن الاستجابة قد بدأت بالفعل، لن يتغير رمز حالة الاستجابة.

{"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"}