エラーとトラブルシューティング

Linux、macOS、Windows をサポートし、Node.js 18+ と最新のブラウザが必要です。すべてのAI処理はクラウドAPIで行われるため、ローカルマシンの構成がどんなに普通でも足を引っ張ることはなく、高性能グラフィックスカードはまったく使えない。

Agnes AI の API Key を 1 つだけ。Agnes AIの公式サイト（agnes-ai.com）に登録すると無料で入手でき、テキスト、画像、ビデオ生成、音声合成に使用されます。すべての機能は、追加の構成なしで Agnes AI の無料モデルから提供されます。

サポートします。原稿の長いビデオモードはバッチ処理のために設計されています：長い文章を投げ込むと、自動的に複数の段落に分割され、段落ごとにビデオを生成し、さらにナレーションと字幕を統一的に追加します。

ブレークポイントがあります。生成タスクが中断された場合（ネットワーク切断、再起動など）、再起動は自動的に前の成功したチェックポイントから続いて走り、進度は失われません。 失敗の大半は、モデルサービスの変動、ネットワークタイムアウト、レート制限などの一時的な要因によるものです。まず失敗パネルの「タスクを再試行」をクリックすると、失敗したステップからチェックポイントベースで再開し、多くの場合は自然に回復します。

失敗の大半は、モデルサービスの変動、ネットワークタイムアウト、レート制限などの一時的な要因によるものです。まずアプリ内の失敗パネルで「タスクを再試行」をクリックしてください。タスクは失敗したステップから再開され、多くの場合は再送信なしで自然に回復します。数回（2 回以上）再試行しても失敗する場合は、フィードバック領域が自動的に展開され、診断情報をワンクリックでコピーし、事前入力済みの GitHub Issue にジャンプできます。環境を手動で説明する必要はありません。

Agnes は Video 2.5 Flash などの動画モデル用に共有の無料推論キューを運用しており、ピーク時には 10 分以上にわたって満杯のままになることがあります。キューが満杯のとき、送信はすべて拒否され、HTTP 503 · video_queue_full と生のメッセージ「video queue is full, please retry later (request id: …)」が返ります。このときタスクは作成されず、クォータも消費されず、失われるものは何もありません。これは Agnes 側の処理能力の問題で、あなたのプロンプトや設定とは関係ありません。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 の両方で提供されています。アプリ内でタスクが失敗すると、失敗パネルに「診断情報をコピー」「GitHub で Issue を作成」ボタンが表示され、アプリのバージョン、タスクの種類、失敗したステップ、エラーメッセージ、再試行回数が自動的に添付されるため、メンテナーが迅速に問題を特定できます。GitHub Issues ページ（github.com/lcy362/agnes-video-generator/issues）から既存の報告を確認したり、新しい Issue を作成したりすることもできます。