클라우드 연결 및 API 키 오류

유효하지 않은 API 키

연결을 테스트할 때 Invalid or unauthorized API key 또는 Server returned [오류 코드] 같은 메시지가 표시될 수 있습니다. 이런 메시지 중 일부는 영어로 표시됩니다.

다음을 확인하세요.

1. 키를 빠짐없이 올바르게 붙여넣었는지 확인하세요. 불필요한 공백을 남기지 마세요(앱이 앞뒤 공백은 제거합니다).
2. 키가 아직 유효한지, 그리고 제공자 계정에 잔액이나 할당량이 남아 있는지 확인하세요.
3. 키 권한(ElevenLabs). 키에 Speech to Text, Text to Speech, Voices(읽기) 권한이 필요합니다. 모든 권한을 포함해 키를 다시 만드세요.
4. 기본 URL이 올바른지 확인하세요(사용자 지정 제공자의 경우). Invalid base URL 오류는 주소 형식이 올바르지 않다는 뜻입니다.
5. VieNeu 키는 만들 때 한 번만 표시됩니다. 분실했다면 새 키를 만드세요.

제공자별 안내는 API 키로 클라우드 연결 추가하기를 참고하세요.

회의 중 클라우드 전사가 중단되는 경우

• Mac: 음성 인식 실패 — 온디바이스 인식으로 전환했습니다. 엔진/키를 확인하세요. 배너가 표시됩니다. 앱은 세션이 끝날 때까지 Apple로 전환합니다. 키를 수정한 다음 새 세션을 시작하세요.
• iPhone 및 iPad: 세션 도중 클라우드가 끊기면 오디오는 계속 녹음되지만 새 텍스트가 표시되지 않을 수 있으며, 앱은 아직 메시지를 표시하지 않습니다. 중지하고 저장한 뒤 다시 녹음하고, 키와 네트워크를 확인하세요.

ElevenLabs 글자 수 소진(읽어주기 음성, Mac)

ElevenLabs를 사용하면 회의 중 화면에 N자 남음 칩이 표시됩니다. 글자 수가 모두 소진되면 앱이 기기 내 음성으로 대신 읽습니다. 남은 글자 수를 확인할 수 없음이 표시되면 키에 계정 정보를 읽을 권한이 없는 것이며, 읽어주기는 계속 작동할 수 있습니다.

제공자가 반환하는 오류

일부 제공자 오류는 보통 영어로 된 기술적인 표현 그대로 표시됩니다. 자주 나타나는 오류는 다음과 같습니다.

• 401 / unauthorized: 키가 잘못되었거나 만료되었습니다.
• 402 / quota / insufficient: 잔액이나 할당량이 부족합니다.
• 429: 요청이 너무 많이 전송되었으므로 잠시 기다렸다가 다시 시도하세요.
• Network error / timeout: 인터넷 연결을 확인하세요.

연결을 삭제할 수 없는 경우

현재 어떤 기능의 엔진으로 사용 중인 연결은 삭제할 수 없습니다. 먼저 설정 → 지능 및 엔진에서 해당 기능을 다른 엔진으로 바꾸세요.

해결되지 않나요? 문제 신고를 이용하세요.