الطلبات والردود والأخطاء

تُرجع البوابة هياكل متوافقة مع OpenAI. أما الحقول الخاصة بالمنصة، مثل request_id، فتُقدَّم في شكل رؤوس استجابة.

استجابة النجاح

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "choices": [
    { "index": 0, "message": { "role": "assistant", "content": "..." }, "finish_reason": "stop" }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 34,
    "total_tokens": 46
  }
}

تنسيق الخطأ الموحد

{
  "error": {
    "message": "...",
    "type": "...",
    "code": "...",
    "param": null,
    "request_id": "req_..."
  }
}
الحقل الوصف
message وصف الخطأ المقروء بواسطة الإنسان
type فئة الخطأ
code رمز الخطأ القابل للقراءة آليًّا
param المعلمة ذات الصلة (null في حالة عدم وجودها)
request_id معرّف تتبع الطلب

رموز الأخطاء

انظر مرجع رموز الأخطاء للاطلاع على القائمة الكاملة ودلالات الفوترة.