الأخطاء واستكشاف الأخطاء وإصلاحها

يدعم Linux و macOS و Windows ، ويتطلب Node.js 18+ ومتصفح حديث. تتم جميع معالجة الذكاء الاصطناعي عبر واجهة برمجة التطبيقات السحابية ، لذلك بغض النظر عن مدى شيوعية تكوين الجهاز المحلي ، فلن يتم إعاقته ، ولن تكون بطاقات الرسومات عالية الأداء ضرورية على الإطلاق.

فقط مفتاح واجهة برمجة التطبيقات Agnes AI. يمكنك الحصول عليه مجانًا عن طريق التسجيل على الموقع الرسمي لـ Agnes AI (agnes-ai.com)، ويتم استخدامه لإنشاء النص والصور والفيديو وتوليف الكلام. تأتي جميع القدرات من نماذج Agnes AI المجانية دون تكوين إضافي.

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

هناك نقاط توقف لاستئناف البث. إذا تم مقاطعة مهمة التوليد (قطع الشبكة ، إعادة التشغيل ، وما إلى ذلك)، فإن إعادة التشغيل ستستمر تلقائيًا من آخر نقطة تفتيش ناجحة ، ولن يفقد التقدم. معظم حالات الفشل سببها عوامل عابرة مثل تقلبات خدمة النموذج أو انتهاء مهلة الشبكة أو تحديد المعدل. انقر «إعادة محاولة المهمة» في لوحة الفشل أولًا — ستستأنف المهمة من الخطوة الفاشلة (بحسب نقاط التحقق) وتتعافى عادةً من تلقاء نفسها.

معظم حالات الفشل سببها عوامل عابرة مثل تقلبات خدمة النموذج أو انتهاء مهلة الشبكة أو تحديد المعدل. انقر «إعادة محاولة المهمة» في لوحة الفشل داخل التطبيق أولًا — ستستأنف المهمة من الخطوة الفاشلة وتتعافى عادةً من تلقاء نفسها دون إعادة إرسال. إذا استمر الفشل بعد عدة محاولات (≥ 2)، تنفتح منطقة الملاحظات تلقائيًا: انسخ معلومات التشخيص بنقرة واحدة وانتقل إلى Issue على GitHub معبأ مسبقًا، دون وصف بيئتك يدويًا.

يشغّل Agnes طابور استدلال مجانيًا مشتركًا لنماذج الفيديو مثل Video 2.5 Flash، وقد يبقى ممتلئًا لأكثر من 10 دقائق في ساعات الذروة. عندما يمتلئ الطابور، يُرفض كل إرسال برمز HTTP 503 · video_queue_full والرسالة الأصلية «video queue is full, please retry later (request id: …)». لا تُنشأ أي مهمة، ولا يُستهلك أي رصيد، ولا يُفقد شيء — هذه مسألة سعة من جهة Agnes وليست مشكلة في الـ prompt أو الإعداد لديك. منذ الإصدار v7.0، لم يعد الرفض بسبب امتلاء الطابور يُحتسب ضمن ميزانية إعادة المحاولة العادية: بل ينتقل إلى مسار إعادة محاولة مخصص (حتى 15 محاولة افتراضيًا، قابل للضبط عبر AGNES_VIDEO_BUSY_RETRY_ATTEMPTS)، وتُطلق المحاولة الأولى فورًا واللاحقة بفاصل 30–60 ثانية. منذ الإصدار v7.1، تقترح لوحة الأخطاء وإشعار إنشاء المهمة أيضًا نوافذ خارج الذروة التي يكون فيها الخادم الأعلى أكثر سلاسة تاريخيًا، معروضة بتوقيتك المحلي. لتجنّب أخطاء Agnes 503: أعد المحاولة في ساعات خارج الذروة، أو انتقل إلى نموذج فيديو آخر (يستخدم Video 2.0 طابورًا منفصلًا وغالبًا ما يقبل المهام)، أو أضف مفاتيح API أكثر — لكل مفتاح رصيده الخاص. وملاحظة أخرى من المزوّد: يبدأ موقع Agnes الصيني تطبيق التحقق من الهوية اعتبارًا من 2026-10-26 12:00 (بتوقيت بكين) — وستنخفض وتيرة استدعاءات API للحسابات غير الموثّقة — ويتوقّع المزوّد تحسّنًا كبيرًا في أخطاء الازدحام مثل 503 و«queue is full» بعد ذلك الموعد.

تعني استجابة 401 Unauthorized أو «رمز غير صالح» عادةً أن مفتاح API لا يطابق النطاق الذي يُرسَل إليه الطلب — على سبيل المثال، مفتاح صادر عن الموقع العالمي يُستخدم مع نقطة النهاية المحلية الصينية api.agnes-ai.cn (أو العكس). تُرفض المفاتيح الصادرة لمواقع مختلفة إذا أُرسلت إلى النطاق الخطأ. اعتبارًا من v6.4.2، يمكن ربط كل مفتاح بنطاق وصوله الخاص، ويقوم زر «اكتشاف النطاقات تلقائيًا» بنقرة واحدة بفحص كل مفتاح عبر com / cn / cn_bak وملء النطاق المطابق تلقائيًا. من لوحة مفاتيح API، اختر النطاق المطابق لمفتاحك أو شغّل الاكتشاف التلقائي ببساطة. يجب أن تستخدم مفاتيح الموقع العالمي apihub.agnes-ai.com، أو نطاق cn_bak الاحتياطي (apihub.agnes-ai.cn، الذي يقبل المفاتيح المحلية والعالمية معًا).

الملاحظات متاحة داخل التطبيق وعلى GitHub معًا. عند فشل مهمة في التطبيق، تتيح لوحة الفشل زرّي «نسخ معلومات التشخيص» و«فتح Issue على GitHub»، مع إرفاق تلقائي لإصدار التطبيق ونوع المهمة والخطوة الفاشلة ورسالة الخطأ وعدد محاولات الإعادة لمساعدة المشرفين على تحديد المشكلة بسرعة. يمكنك أيضًا زيارة صفحة GitHub Issues (github.com/lcy362/agnes-video-generator/issues) للاطلاع على التقارير الحالية أو فتح تقرير جديد.