---
title: "BYOK 설정 — 내 API 키로 사용하기 | VoxisLive"
description: "VoxisLive BYOK 잠금 해제 설정 방법: Google Gemini 키를 추가하고, Alibaba Qwen 자격 증명 파일 전체를 붙여넣어 키와 워크스페이스를 한 번에 채운 뒤, 올바른 탭에서 번역을 시작하세요."
url: https://voxislive.com/ko/byok-setup
language: "ko"
source_html: https://voxislive.com/ko/byok-setup
site: "Voxis — real-time voice translation"
og_image: https://voxislive.com/assets/og.png
generated_by: voxislive-markdown-pipeline
---

[홈](https://voxislive.com/ko/) · / · BYOK 설정

BYOK

# 내 API 키 설정하기

BYOK 잠금 해제는 Voxis를 내 Google Gemini 또는 Alibaba Qwen API 키로 실행하게 해 줍니다 — 한 번의 구매로 Windows 앱과 Chrome 확장 프로그램을 모두 사용할 수 있습니다. 이 페이지는 처음부터 키를 올바르게 설정하는 방법을 안내합니다.

잠금 해제는 두 앱을 모두 포함하는 **99.99달러**의 1회성 구매이며, **활성화 후에는 환불되지 않습니다**. 활성화 시점부터 번역은 본인의 키로 실행되며, 계정에 남아 있는 선불 Voxis 분량은 더 이상 사용할 수 없습니다. [요금제](https://voxislive.com/ko/pricing#byok)와 [환불 정책](https://voxislive.com/ko/refund)을 참고하세요.

## 1. 시작하기 전에

- 계정에 **BYOK 잠금 해제**가 필요합니다 — 일회성 구매입니다. [요금](https://voxislive.com/pricing#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가 자동으로 라우팅합니다.

FAQ

## 자주 묻는 질문

### 내 API 키가 Voxis로 전송되나요?

아니요. 키는 기기에만 저장됩니다 — 앱에서는 Windows DPAPI로 암호화되고, 브라우저에서는 확장 프로그램의 로컬 저장소에 보관됩니다. 번역 세션은 기기에서 Google 또는 Alibaba로 직접 연결되며, Voxis는 계정에 BYOK 라이선스가 있는지만 확인합니다.

### BYOK 세션이 내 Voxis 분을 소모하나요?

아니요. BYOK에서는 Voxis 분 잔액이 전혀 줄지 않습니다 — 사용량은 내 키로 제공사가 청구합니다.

### 한 번의 구매로 앱과 확장 프로그램을 모두 쓸 수 있나요?

네. 라이선스는 계정에 귀속되므로 Windows 앱과 Chrome 확장 프로그램이 같은 구매로 함께 잠금 해제됩니다.

### Gemini 키와 Qwen 키를 동시에 저장해 둘 수 있나요?

네. 두 자리는 나란히 유지되고, Voxis가 대상 언어별로 엔진을 고릅니다. 빈 입력란으로 저장해도 아무것도 바뀌지 않으며, 지우기는 저장된 키를 삭제합니다.

## 더 읽어보기

[브라우저 확장 프로그램 · 어떤 탭이든 내 언어로 번역되어 음성으로, 실시간으로 들으세요.](https://voxislive.com/extension) · [요금 · 플랜, 분 패키지, 일회성 BYOK 잠금 해제.](https://voxislive.com/pricing#byok) · [라이선스 · 상업적 조건과 공개 저장소가 허용하는 것, 허용하지 않는 것.](https://voxislive.com/licensing)


## Structured data (JSON-LD)

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "홈",
          "item": "https://voxislive.com/ko/"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "BYOK 설정",
          "item": "https://voxislive.com/ko/byok-setup"
        }
      ]
    },
    {
      "@type": "FAQPage",
      "mainEntity": [
        {
          "@type": "Question",
          "name": "내 API 키가 Voxis로 전송되나요?",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "아니요. 키는 기기에만 저장됩니다 — 앱에서는 Windows DPAPI로 암호화되고, 브라우저에서는 확장 프로그램의 로컬 저장소에 보관됩니다. 번역 세션은 기기에서 Google 또는 Alibaba로 직접 연결되며, Voxis는 계정에 BYOK 라이선스가 있는지만 확인합니다."
          }
        },
        {
          "@type": "Question",
          "name": "BYOK 세션이 내 Voxis 분을 소모하나요?",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "아니요. BYOK에서는 Voxis 분 잔액이 전혀 줄지 않습니다 — 사용량은 내 키로 제공사가 청구합니다."
          }
        },
        {
          "@type": "Question",
          "name": "한 번의 구매로 앱과 확장 프로그램을 모두 쓸 수 있나요?",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "네. 라이선스는 계정에 귀속되므로 Windows 앱과 Chrome 확장 프로그램이 같은 구매로 함께 잠금 해제됩니다."
          }
        },
        {
          "@type": "Question",
          "name": "Gemini 키와 Qwen 키를 동시에 저장해 둘 수 있나요?",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "네. 두 자리는 나란히 유지되고, Voxis가 대상 언어별로 엔진을 고릅니다. 빈 입력란으로 저장해도 아무것도 바뀌지 않으며, 지우기는 저장된 키를 삭제합니다."
          }
        }
      ]
    },
    {
      "@type": "WebPage",
      "name": "BYOK 설정 — 내 API 키로 사용하기 | VoxisLive",
      "url": "https://voxislive.com/ko/byok-setup",
      "description": "VoxisLive BYOK 잠금 해제 설정 방법: Google Gemini 키를 추가하고, Alibaba Qwen 자격 증명 파일 전체를 붙여넣어 키와 워크스페이스를 한 번에 채운 뒤, 올바른 탭에서 번역을 시작하세요.",
      "inLanguage": "ko",
      "dateModified": "2026-08-30",
      "isPartOf": {
        "@type": "WebSite",
        "name": "VoxisLive",
        "url": "https://voxislive.com/"
      }
    }
  ]
}
```