API 개요

VocalLab API를 사용하면 직접 만든 앱, 스크립트, 자동화 도구에서 음성을 생성하고, 음성 목록을 조회하고, 잔액을 확인할 수 있습니다.

Studio 플랜 필요. API 액세스는 Studio에 포함되어 있습니다. 개발자 설정에서 키를 생성하세요.

기본 URL

https://api.vocallab.ai

인증

모든 요청에 API 키를 Bearer 토큰으로 전송하세요:

Authorization: Bearer vl_live_...

키는 개발자 페이지에서 생성하고 폐기합니다. 키는 비밀번호처럼 다루세요. 한 번만 표시되며, 키를 가진 사람은 누구나 포인트를 사용할 수 있습니다. API 키를 참조하세요.

할 수 있는 것

• 음성 생성 — POST /api/v1/tts (선택적으로 model 전달)
• 음성 목록 조회 — GET /api/v1/voices (카탈로그 + 내 클론 및 디자인 음성)
• 모델 목록 조회 — GET /api/v1/models (VocalLab Studio / Pro / Lite)
• 상태 확인 / 호스팅 URL 가져오기 — GET /api/v1/tts/:id
• 잔액 확인 — GET /api/v1/ping 또는 GET /api/v1/me

모델 선택

POST /api/v1/tts에 "model"을 전달해 엔진을 선택하세요(기본값 v-pro):

• v-studio — VocalLab Studio: 최신, 스티어링 가능(표현 지시를 따름), 200개 이상 언어.
• v-pro — VocalLab Pro: 최고 음질, 15개 언어. 기본값.
• v-lite — VocalLab Lite: 빠르고 경제적 — 절반 포인트로 청구.

API 키는 세 가지 모두 사용할 수 있습니다. 자세한 내용은 음성 모델을 참조하세요.

자세한 내용은 API 레퍼런스를 참조하세요.

결제

API 생성은 웹 앱과 동일한 포인트를 사용합니다 — 1포인트 = 오디오 1초. API는 초당 15자로 측정하며(웹 앱의 17자보다 약간 더 많음), 잔액보다 더 많이 사용할 수는 없습니다. 포인트가 부족한 요청은 402를 반환합니다.

AI 도구 안에서 사용하기

Claude, Cursor 또는 다른 AI 어시스턴트를 선호하시나요? MCP 서버는 동일한 기능을 네이티브 도구로 노출하며, 호스팅 옵션을 사용하면 설치할 것이 없습니다.