الانتقال إلى المحتوى الرئيسي

نظرة عامة

تضمن حدود التزامن الاستخدام العادل واستقرار واجهة API. يعتمد عدد المهام التي يمكن تشغيلها في وقت واحد على خطتك.

الحدود حسب الخطة

تحدد خطتك مستوى التزامن لديك، وهو يُضبط لكل نموذج ويُحتسب لكل مستخدم. يمكن للخطط الأعلى مستوى تشغيل عدد أكبر من المهام في الوقت نفسه.
تواصل مع المبيعات للحصول على تفاصيل خطة Enterprise والتزامن المخصص.
يكون التراكم معطّلًا أيضًا لطلبات Zero Data Retention ولبعض النماذج، حتى في الخطط التي تسمح به عادةً. لا تُضاف طلبات Krea 2 إلى التراكم في أي خطة حاليًا.

تراكم المهام

عندما يكون التراكم متاحًا، تُقبل المهام التي ترسلها فوق حد التزامن لديك بالحالة status: "backlogged". وتبدأ بترتيب إرسالها كلما انتهت المهام قيد التشغيل. لا يوجد حد منفصل للتراكم. عندما لا يكون التراكم متاحًا، قد تُرفض المهمة الإضافية باستجابة HTTP 429 بدلًا من وضعها في قائمة الانتظار. الحد تقريبي: فقد تُقبل دفعة قصيرة من الطلبات فوقه. عند تلقي 429، أعد المحاولة مع التراجع بعد انتهاء المهام الجارية. تجد نص الاستجابة والترويسات في الأخطاء وتصحيحها.
استخدم الويب هوك لتلقّي إشعار عند اكتمال المهمة أو فشلها أو إلغائها.

أفضل الممارسات

  • نفّذ التراجع الأسّي - انتظر لفترات أطول تدريجيًا بين إعادات المحاولة
  • ضع الطلبات في قائمة انتظار على جانب العميل - قد تُقبل دفعة من الطلبات فوق الحد، لذا لا تعتمد على واجهة API لإيقاف الطلب التالي
  • راقب استخدامك - تتبّع عدد الطلبات للبقاء ضمن الحدود
  • استخدم الويب هوك - قلّل طلبات الاستعلام باستخدام الويب هوك لاكتمال المهام

الخطوات التالية

مفاتيح API والفوترة

راقب استخدامك ومقاييسك لواجهة API

الويب هوك

قلّل الاستعلام باستخدام الويب هوك

الأخطاء وتصحيحها

نصوص استجابات 429، والتراجع، ورموز المهام الفاشلة