1. 시작하기 전에
- 계정에 BYOK 잠금 해제가 필요합니다 — 일회성 구매입니다. 요금을 확인하세요. 구매한 계정으로 앱 또는 확장 프로그램에 로그인하세요.
- 제공사에서 키를 발급받으세요: Gemini는 Google AI Studio에서, Qwen은 Alibaba Cloud Model Studio(International 에디션)에서 만듭니다.
- 키 입력란은 하나입니다. Voxis는 키 자체로 제공사를 인식합니다:
AIza…는 Gemini,sk-…는 Qwen입니다. 두 키를 나란히 저장할 수 있으며, Voxis가 대상 언어별로 최적의 엔진을 고릅니다(Qwen은 약 29개 대상 언어를 자연스러운 음성으로 말하고, Gemini는 79개 전부를 지원합니다).
2. Gemini 키 추가
Google AI Studio에서 API 키를 만들고 AIza… 값을 복사해 키 입력란에 붙여넣고 저장하세요. Gemini에는 워크스페이스 줄이 나타나지 않습니다 — 정상이며, Gemini에는 워크스페이스가 필요 없습니다.
3. Qwen 키 추가 — 파일 전체를 붙여넣기
Model Studio는 키를 다운로드 가능한 작은 자격 증명 파일(CSV)로 제공합니다. 모든 것을 제대로 작동하게 하는 단 하나의 규칙:
파일 경로를 붙여넣지 말고, 키만 붙여넣지도 마세요. 파일을 열어 내용 전체를 선택·복사한 뒤, 전부를 키 입력란에 붙여넣으세요.
Voxis는 붙여넣은 내용에서 API 키와 워크스페이스, 두 조각을 한 번에 읽어냅니다. Qwen 키는 특정 워크스페이스에 속하며 — 특히 브라우저에서는 — 워크스페이스가 연결 주소 자체의 일부이기 때문에, 워크스페이스 없이는 키가 아예 연결되지 않습니다.
sk-…키만 붙여넣었다면? Voxis가 워크스페이스를 콕 집어 요청합니다.- 파일 경로(예:
C:\Users\…\key.csv)를 붙여넣었다면? "API 키를 붙여넣으세요" 경고가 표시됩니다 — 파일의 내용을 붙여넣으세요. - 키는 International Model Studio에서 만드세요. 잘못된 리전의 키는 마치 잘못된 키처럼 실패합니다.
4. 번역 시작
확장 프로그램에서: 영상이 재생 중인 탭을 열고 Voxis 아이콘을 클릭한 뒤, 시작 버튼 아래 줄을 확인하세요 — 번역될 탭의 이름이 표시됩니다("시작하면 이 탭을 번역합니다: …"). 다른 탭이 표시되면 영상 탭으로 이동해 거기서 팝업을 여세요. 그런 다음 시작을 누르세요. Windows 앱에서는 비디오/게임 또는 회의 모드를 선택해 시작하세요 — 첫 번역 음성이 나오기까지 몇 초 걸릴 수 있습니다.
문제가 있을 때
- "API 키를 붙여넣으세요" 경고 — 파일 경로나 일반 텍스트를 붙여넣었습니다. 파일을 열어 내용을 붙여넣으세요.
- 시작 직후 워크스페이스를 지목하는 오류 — 워크스페이스가 없습니다. 자격 증명 파일 전체를 다시 붙여넣으세요.
- 키/워크스페이스 짝에 대한 빠르고 구체적인 오류 — 둘이 서로 맞지 않거나 리전이 잘못되었습니다. 파일을 다시 내려받아 다시 붙여넣으세요.
- 연결됐지만 소리가 없음 — 영상이 재생 중인 탭에서 시작을 눌렀는지, 영상이 실제로 재생 중인지 확인하세요.
- Qwen 키만으로 어떤 언어가 시작되지 않음 — 그 대상 언어에는 Qwen 음성이 없습니다. Gemini 키도 추가하세요. Voxis가 자동으로 라우팅합니다.