API 및 고급 오류

기술 오류 메시지

“OpenAI API 키가 설정되지 않았습니다”

서버의 API 키가 없거나 유효하지 않은 구성 문제입니다. 사용자가 수정할 수 없으므로 오류를 지원팀에 알려 주세요.

“CSRF 토큰 검증 실패”

• 페이지를 오래 열어 둬 보안 토큰이 만료됐을 수 있습니다.
• Cmd/Ctrl+R로 새로 고친 뒤 작업을 다시 시도합니다.
• 계속되면 사이트 쿠키를 지우고 로그아웃 후 다시 로그인합니다.

“봇 상태를 가져오지 못했습니다”(Recall.ai)

• 외부 회의 API가 일시적으로 응답하지 않을 수 있습니다.
• 페이지를 새로 고쳐 상태 확인을 다시 시도합니다.
• 실제 회의 참가자 목록에 봇이 있다면 상태 오류와 관계없이 녹음 중일 수 있습니다.

“회로 차단기 열림 — 화자 분리 서비스 중단”

• 화자 분리 서비스의 일시적 장애입니다.
• 텍스트 변환은 계속되지만 화자 라벨이 빠질 수 있습니다.
• 화자 라벨이 꼭 필요하면 몇 시간 뒤 화자 분리를 켜고 다시 업로드합니다.

“요청 시간 초과” 또는 ETIMEDOUT

• 인터넷 연결 또는 서버 부하가 원인일 수 있습니다.
• 새로 고치거나 “다시 시도”를 누릅니다.
• 다른 웹사이트가 열리는지 확인합니다.
• 서버가 혼잡하면 10~15분 뒤 다시 시도합니다.

“파일 크기가 maxBodyLength를 초과했습니다”

파일이 요금제 한도(무료 50MB, Plus 2GB, Premium 5GB)를 넘었습니다. 더 낮은 비트레이트로 압축하거나 파일을 나누고, 필요하면 요금제를 업그레이드하세요.

500 또는 502 서버 오류

• 일시적인 서버 문제이며 사용자 파일의 잘못이 아닙니다.
• 5~10분 뒤 다시 시도합니다.
• 1시간 이상 계속되면 오류 화면과 발생 시간을 지원팀에 보냅니다.

401 또는 403 오류

• 401: 세션이 만료됐을 수 있으므로 다시 로그인합니다.
• 403: 현재 요금제에 없는 기능이거나 접근 권한이 없는 파일입니다.
• 본인 소유이거나 명시적으로 공유받은 텍스트 변환만 열 수 있습니다.