الأخطاء وإعادة المحاولة
معنى كل حالة والإجراء المناسب.
تأتي الأخطاء بصيغة JSON مع حقل detail. اعتمد على الحالة وترويسات إعادة المحاولة؛ احتفظ بـ detail للسجلات والإرشادات.
| الحالة | المعنى | الإجراء |
|---|---|---|
400 | إدخال غير صالح أو محرك غير معروف أو توجيه خاطئ | صحّح الطلب أو اختر محركًا متاحًا |
401 | رمز PIN أو مفتاح API مفقود أو غير صحيح | أرسل بيانات الاعتماد |
403 | لا يمكن للمستدعي استخدام مسار محلي أو إداري | استخدم عنوان loopback أو مسارًا مسموحًا |
409 | نموذج أو حالة مطلوبة مفقودة | ثبّت النموذج الموصى به أو حل التعارض |
422 | فشل التحقق من متن الطلب | صحّح أسماء الحقول أو أنواعها أو نطاقاتها |
429 | قائمة انتظار GPU ممتلئة | انتظر Retry-After ثم أعد المحاولة |
500 | فشل غير متوقع في المحرك أو الخادم | سجّل detail؛ أعد المحاولة فقط إذا كان ذلك آمنًا |
503 | تحميل المحرك أو التوليد غير متاح لفترة قصيرة | التزم بقيمة Retry-After |
504 | انتهت مهلة تفريغ أو توليد محمي | أعد المحاولة مرة واحدة؛ قلّل حجم المهمة إذا تكرر ذلك |
إعادة المحاولة
أعد محاولة 429 و503 القابلة لإعادة المحاولة و504 باستخدام تراجع أسي محدود. قد يرسل VoiceStudio:
Retry-After: 30
X-OmniVoice-Retryable: trueلا تعِد محاولة 400 أو 401 أو 403 أو 422 تلقائيًا. تتطلب 409 تثبيت نموذج أو إجراء تغيير واضح آخر أولًا.
في مهام الدبلجة والدفعات، استأنف من حالة المهمة بعد انقطاع الاتصال بدلًا من رفع الوسائط مجددًا.