오류 및 문제 해결

Linux, macOS 및 Windows를 지원하며 Node.js 18+ 및 최신 브라우저가 필요합니다. 모든 AI 처리는 클라우드 API에서 이루어지기 때문에 로컬 기계 구성이 아무리 평범해도 발목이 잡히지 않으며 고성능 그래픽 카드는 전혀 사용할 수 없다.

Agnes AI의 API Key 하나만 있으면 됩니다. 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를 열 수도 있습니다.