الوثائق

الأخطاء / حدود معدل الطلبات

الأخطاء

تحتوي أخطاء HTTP على كائن خطأ يضم الرمز (code) والرسالة (message). يمكن للمهمة المقبولة بنجاح أن تفشل لاحقًا؛ لذا استعلم عن المهمة أو تعامل مع خطاك الراجع للفشل.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

HTTP	الحقل	الإجراء المطلوب
400	`invalid_request`	قم بتصحيح الـ JSON، أو الوصف المفقود، أو نطاق المعلمات، أو رابط الوسائط قبل إعادة المحاولة.
401	`invalid_api_key`	تحقق من الرمز الحامل (Bearer token) وما إذا كان مفتاح الـ API نشطًا.
402	`insufficient_credits`	أضف رصيدًا أو قلل من تكلفة المهمة. قد تتضمن الاستجابة المبالغ المطلوبة والمتاحة.
403	`forbidden`	يرجى التحقق من القيود المفروضة على الحساب والموضحة في رسالة الخطأ.
404	`not_found`	تحقق من معرف المهمة وتأكد من أن المفتاح ينتمي لمستخدم المهمة.
429	`rate_limited`	انتظر للمدة المحددة في Retry-After قبل إعادة المحاولة.
500	`internal_error`	تحقق من رسالة الخطأ وسجلات الـ API. أعد المحاولة بحذر؛ حيث يمكن أن يؤدي إعادة إرسال طلب الإنشاء إلى إنشاء مهمة أخرى خاضعة للرسوم.

حدود معدل الطلبات

إنشاء المهام: يتيح كل مفتاح واجهة برمجة تطبيقات (API key) ما يصل إلى 100 طلب في الدقيقة افتراضيًا. حدود معدل الطلبات المخصصة غير متوفرة حاليًا.

الاستعلام عن المهام: يتيح كل مفتاح واجهة برمجة تطبيقات (API key) ما يصل إلى 120 طلبًا في الدقيقة افتراضيًا. ويتم احتساب طلبات الاستعلام وطلبات إنشاء المهام بشكل منفصل.

تتشارك طلبات إنشاء الصور والفيديو نفس حد معدل الطلبات الخاص بمفتاح واجهة برمجة التطبيقات API key.

يتضمن خطأ HTTP 429 الرأس Retry-After: 60 لعمليات الإنشاء، والرأس Retry-After: 5 للاستعلامات. استخدم التراجع التدريجي وتجنب الاستقصاء بمعدل أكبر من اللازم.

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 60

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}