حد مهام API#

تستخدم واجهات برمجة التطبيقات الخاصة بالتوليد معالجة المهام غير المتزامنة. عند إنشاء المهمة بنجاح، يُرجع API قيمة taskId. استخدم نقطة النهاية الخاصة بالنتائج للتحقق من حالة المهمة، والتقدم، وموضع الطابور، والإخراج النهائي.

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

ملخص حد معدل الطلبات#

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

سير العمل	الطلبات في الدقيقة	المهام المتزامنة / غير المكتملة	خصم الرصيد
إنشاء 3D بالذكاء الاصطناعي	لا يوجد حد RPM عام ثابت	1 مهمة قيد التشغيل في كل مرة. تنتظر المهام الإضافية المرسلة في الطابور.	يُخصم الرصيد لكل مهمة مقبولة
واجهات برمجة تطبيقات توليد أخرى	لا يوجد حد RPM عام ثابت	ما يصل إلى 30 مهمة غير مكتملة لكل حساب وسير عمل	يُخصم لكل مهمة مقبولة

تشمل المهام غير المكتملة كل من المهام المعلقة في الطابور والمهام قيد التشغيل.

حد 30 مهمة هو حد لعدد المهام، وليس حزمة أرصدة أو حصة مجانية. تُحتسب تكلفة كل مهمة إنشاء مقبولة وفق قواعد الأرصدة الخاصة بتلك API.

حالة المهمة#

الحالة	المعنى	تُحتسب كغير مكتملة
`Unprocessed`	تم قبول المهمة وهي تنتظر التشغيل	نعم
`Processing`	المهمة قيد التشغيل حالياً	نعم
`Success`	اكتملت المهمة بنجاح	لا
`Failed`	فشلت المهمة	لا

قد تُرجع نقطة نهاية النتائج أيضاً قيمة waitNumber، والتي تشير إلى موضع الطابور للمهمة المنتظرة. عندما تكون المهمة قيد التشغيل أو مكتملة، تكون قيمة waitNumber عادةً 0.

مهام AI 3D#

تُعالج مهام AI 3D واحدة تلو الأخرى.

يمكنك إرسال عدة مهام AI 3D، وسيقوم كل إرسال ناجح بإرجاع taskId. ومع ذلك، يعمل مهمة AI 3D واحدة فقط في المرة الواحدة. تنتظر مهام AI 3D الإضافية حتى تنتهي المهمة الحالية.

سلوك التكامل الموصى به:

احفظ taskId المُرجع.
استعلم دوريًا عن نقطة نهاية النتائج كل 3-5 ثوانٍ.
عامل Unprocessed على أنها في انتظار.
عامل Processing على أنها قيد التشغيل بنشاط.
استخدم waitNumber و percentage لإظهار التقدم للمستخدمين.

مهام التوليد الأخرى#

لأنماط التوليد الأخرى غير مهام AI 3D، يمكن أن يحتوي كل حساب على ما يصل إلى 30 مهمة غير مكتملة لنفس سير العمل.

هذا حد على مستوى الحساب. إذا تم إنشاء عدة مفاتيح API تحت الحساب نفسه، فإنها تشارك نفس الحد.

هذا لا يعني بالضرورة أن جميع مهام 30 قيد التشغيل في اللحظة نفسها تماماً. قد تكون بعض المهام في الانتظار والبعض الآخر قيد التشغيل. يحسب الحد كليهما.

عندما يكون للحساب بالفعل 30 مهام غير مكتملة لسير عمل معين، قد يتم رفض إرسال المهام الجديدة لذلك سير العمل مؤقتاً حتى تكتمل المهام الحالية.

الرمز	الاسم	المعنى
`9015`	`TASK_NOT_COMPLETED`	وصل الحساب إلى حد المهمة غير المكتملة لهذا سير العمل. أعد المحاولة بعد اكتمال المهام الحالية.

الرصيد والمهام غير المكتملة#

يتم خصم الرصيد عند إنشاء مهمة التوليد بنجاح. إذا فشلت المهمة في النهاية، يتم استرداد الرصيد المخصوم تلقائياً.

لا يغير حد المهمة غير المكتملة تكلفة الرصيد لكل مهمة. إذا أرسلت عدة مهام، يتم فرض الرسوم على كل مهمة مقبولة بشكل منفصل.

أمثلة:

المثال	المهام غير المكتملة النشطة	الرصيد المخصوم عند إنشاء المهمة
إرسال 30 مهام تغيير الأثاث	30	30 x 1 رصيد = 30 رصيد
إرسال 30 مهام ديكور المنزل مع `modelType: "Base"`	30	30 x 3 رصيد = 90 رصيد
إرسال 30 مهام ديكور المنزل مع `modelType: "Pro"`	30	30 x 10 رصيد = 300 رصيد
إرسال 10 مهام تنسيق الحدائق `Flash`، و 10 `Base`، و 10 `Pro`	30	10 x 1 + 10 x 3 + 10 x 10 = 140 رصيد

للحصول على جدول الرصيد الكامل، انظر مرجع خصم الرصيد.

لا يؤدي الاستعلام الدوري عن نقطة نهاية النتائج إلى إنشاء مهمة توليد جديدة، ولا يُحتسب مهمة غير مكتملة.

استجابات الخدمة المزدحمة المؤقتة#

في بعض الحالات، قد يتم رفض إرسال المهام الجديدة مؤقتاً لأن الخدمة مشغولة. يمكن أن يحدث هذا حتى لو كان لدى حسابك أقل من 30 مهمة غير مكتملة.

الرمز	الاسم	المعنى
`5020`	`QUEUE_TASK_OVERFLOW`	الخدمة مشغولة حالياً. أعد المحاولة لاحقاً.

هذا مؤقت. لا تعامله كفشل دائم.

سلوك العميل الموصى به#

احفظ كل taskId مُرجع.
استعلم عن حالة المهمة بانتظام.
احتفظ بقائمة محلية للمهام غير المكتملة لكل حساب وسير عمل.
قم بإزالة المهام من قائمة المهام غير المكتملة عندما تصبح الحالة Success أو Failed.
بالنسبة لأنماط العمل غير الخاصة بـ AI-3D، احفظ المهام غير المكتملة عند أو أقل من 30 قبل إرسال المزيد.
إذا تلقيت 9015 أو 5020، أعد المحاولة بعد تأخير.

سلوك إعادة المحاولة المقترح:

الوضع	الإجراء الموصى به
`9015 TASK_NOT_COMPLETED`	انتظر حتى تكتمل المهام الحالية من نفس الحساب وسير العمل، ثم أعد المحاولة.
`5020 QUEUE_TASK_OVERFLOW`	انتظر وأعد المحاولة باستخدام زيادة فترة الانتظار بين المحاولات.
المهمة في حالة `Unprocessed`	استمر في الاستعلام الدوري؛ المهمة في انتظار.
المهمة في حالة `Processing`	استمر في الاستعلام الدوري؛ المهمة قيد التشغيل.

هل تحتاج إلى قدرة معالجة أعلى؟#

إذا لم يكن حد 30 مهمة غير مكتملة لكل حساب وسير عمل الحالي يلبي احتياجات تكاملك، يرجى التواصل معنا على [email protected]. يمكننا مراجعة حالتك واستخدامك ومناقشة خيارات قدرة المعالجة الأعلى أو ترتيب مخصص.