رموز الأخطاء
تُرجع الطلبات الفاشلة بنية خطأ موحدة؛ ويُعد الحقل code رمزًا قابلاً للقراءة آليًّا.
جدول رموز الأخطاء
| HTTP | الرمز | الفوترة | الوصف |
|---|---|---|---|
| 400 | invalid_request |
لا | معلمات طلب غير صالحة |
| 401 | invalid_api_key |
لا | مفتاح API مفقود أو غير صالح |
| 402 | insufficient_balance |
لا | رصيد غير كافٍ — قم بتعبئة الرصيد |
| 403 | model_not_allowed |
لا | النموذج غير مصرح له باستخدام هذا المفتاح |
| 429 | rate_limit_exceeded |
لا | حد أقصى لعدد المحاولات — أعد المحاولة لاحقًا |
| 500 | billing_settlement_error |
التسوية غير المتزامنة | فشل تسوية الفواتير |
| 502 | upstream_error |
عادةً لا | خطأ في الخدمة المصدرية |
| 503 | model_provider_unavailable |
لا | خدمة النموذج غير متاحة مؤقتًا |
| 504 | upstream_timeout |
عادةً لا | انتهت مهلة الخدمة الأساسية |
استكشاف الأخطاء وإصلاحها
401: تأكد من أن قيمةAuthorization: Bearerهي السر الكاملsk-live-*وأن المفتاح لم يتم إلغاؤه.402: قم بتعبئة الرصيد في وحدة التحكم.429: قلل من عدد العمليات المتزامنة، أو انتظرretry-afterقبل إعادة المحاولة.5xx: أعد المحاولة لاحقًا؛ إذا استمرت المشكلة، فاتصل بدعم العملاء مع ذكرrequest_id.
مثال على الخطأ
{
"error": {
"message": "insufficient balance",
"type": "request_error",
"code": "insufficient_balance",
"param": null,
"request_id": "req_8f2a…c91d"
}
}