خطاها و رفع اشکال

پشتیبانی از لینوکس ، macOS و ویندوز ، نیاز به Node.js 18+ و مرورگرهای مدرن. تمام پردازش هوش مصنوعی در API ابری تکمیل می شود ، بنابراین مهم نیست که پیکربندی ماشین محلی چقدر معمولی باشد ، مانع نمی شود و کارت های گرافیک با کارایی بالا به هیچ وجه قابل استفاده نیستند.

فقط یک کلید API برای Agnes AI. با ثبت نام در وب سایت رسمی Agnes AI (agnes-ai.com) می توانید آن را به صورت رایگان دریافت کنید. از آن برای متن ، تصاویر ، تولید ویدیو و سنتز گفتار استفاده کنید. تمام قابلیت ها از مدل رایگان Agnes AI بدون پیکربندی اضافی می آیند.

پشتیبانی کنید. حالت ویدیوی طولانی نسخه خطی برای پردازش دسته ای طراحی شده است: هنگامی که یک مقاله طولانی پرتاب می شود ، به طور خودکار به چندین پاراگراف تقسیم می شود ، ویدیو پاراگراف به پاراگراف تولید می شود و سپس روایت و زیرنویس به طور یکنواخت اضافه می شود.

یک نقطه شکست برای ادامه وجود دارد. اگر وظیفه تولید قطع شود (قطع شبکه ، راه اندازی مجدد و غیره) ، راه اندازی مجدد به طور خودکار از آخرین ایست بازرسی موفق اجرا می شود و پیشرفت از بین نمی رود. بیشتر شکست‌ها ناشی از عوامل گذرا هستند: نوسان سرویس مدل، تایم‌اوت شبکه یا محدودیت نرخ. ابتدا در پنل شکست روی «تلاش مجدد وظیفه» کلیک کنید — وظیفه از مرحلهٔ شکست‌خورده (بر پایه چک‌پوینت) ادامه می‌یابد و معمولاً خودبه‌خود بازیابی می‌شود.

بیشتر شکست‌ها ناشی از عوامل گذرا هستند: نوسان سرویس مدل، تایم‌اوت شبکه یا محدودیت نرخ. ابتدا در پنل شکستِ برنامه روی «تلاش مجدد وظیفه» کلیک کنید — وظیفه از مرحلهٔ شکست‌خورده ادامه می‌یابد و معمولاً بدون ارسال مجدد خودبه‌خود بازیابی می‌شود. اگر پس از چند تلاش (≥ ۲) همچنان شکست خورد، بخش بازخورد به‌طور خودکار باز می‌شود: اطلاعات عیب‌یابی را با یک کلیک کپی کرده و به Issue گیت‌هاب از پیش پرشده بروید، بدون آنکه لازم باشد محیط خود را دستی توضیح دهید.

Agnes برای مدل‌های ویدیویی مانند Video 2.5 Flash یک صف استنتاج رایگان مشترک اجرا می‌کند که در ساعات اوج می‌تواند بیش از ۱۰ دقیقه پر بماند. وقتی صف پر است، هر ارسال با HTTP 503 · video_queue_full و پیام خام «video queue is full, please retry later (request id: …)» رد می‌شود. هیچ وظیفه‌ای ساخته نمی‌شود، هیچ سهمیه‌ای مصرف نمی‌شود و چیزی از دست نمی‌رود — این موضوع ظرفیت سمت Agnes است، نه مشکلی در prompt یا تنظیمات شما. از v7.0، رد شدن به‌دلیل پر بودن صف دیگر از بودجه تلاش مجدد عادی کم نمی‌شود: به یک مسیر تلاش مجدد اختصاصی می‌رود (به‌طور پیش‌فرض حداکثر ۱۵ تلاش، قابل تنظیم با AGNES_VIDEO_BUSY_RETRY_ATTEMPTS)، اولین تلاش بی‌درنگ اجرا می‌شود و تلاش‌های بعدی با فاصله ۳۰–۶۰ ثانیه انجام می‌شوند. از 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، که هم کلیدهای داخلی و هم جهانی را می‌پذیرد) استفاده کنند.

بازخورد هم درون برنامه و هم در گیت‌هاب ارائه می‌شود. وقتی وظیفه‌ای در برنامه شکست می‌خورد، پنل شکست دکمه‌های «کپی اطلاعات عیب‌یابی» و «باز کردن Issue در گیت‌هاب» را ارائه می‌دهد و نسخه برنامه، نوع وظیفه، مرحله شکست‌خورده، پیام خطا و تعداد تلاش‌های مجدد را به‌طور خودکار پیوست می‌کند تا نگه‌دارندگان سریع مشکل را پیدا کنند. همچنین می‌توانید صفحه GitHub Issues (github.com/lcy362/agnes-video-generator/issues) را ببینید تا گزارش‌های موجود را بررسی یا گزارش جدیدی باز کنید.