만들기 전에 먼저 들어보세요
54개 프리셋 보이스 중 4개 — 이 API로 직접 합성한 샘플입니다. 영어(미국·영국)·스페인어·프랑스어·힌디어·이탈리아어·일본어·포르투갈어·중국어를 지원합니다.
전체 목록: GET /v1/voices — 키 없이 조회 가능. 한국어 보이스는 아직 미지원입니다 (추가 검토 중).
1크레딧 = 1글자. 과금 모델은 이게 전부입니다.
좌석·분·보이스별 요금 없음. 합성 실패 시 크레딧은 자동 환불됩니다.
요청 3번이면 출시 준비 끝
순수 REST, 순수 WAV. HTTP를 보낼 수 있는 언어라면 무엇이든 말할 수 있습니다.
키 발급
curl -X POST https://api.opnvoice.cloud/v1/keys \ -H "content-type: application/json" -d '{"email":"you@company.com"}' → {"api_key":"sk_tts_…","free_credits":5000}
합성
voice 기본값은 af_sarah, speed는 0.5–2.0, 요청당 최대 5,000자.
curl -X POST https://api.opnvoice.cloud/v1/tts \ -H "x-api-key: sk_tts_…" -H "content-type: application/json" \ -d '{"text":"Hello from OpnVoice.","voice":"af_sarah","speed":1.0}' \ -o hello.wav → WAV, 24 kHz mono · x-credits-remaining 헤더로 잔액 확인
상태 코드는 4개뿐
| 상태 | 의미 | 대응 |
|---|---|---|
| 200 | 오디오 반환 | 그대로 사용 |
| 400 | 빈 텍스트, 5,000자 초과, 없는 보이스 | 요청 수정 — 크레딧은 환불됨 |
| 401 | API 키 누락·오류 | x-api-key 헤더 확인 |
| 402 | 크레딧 부족 | 응답 본문의 링크로 충전 |
중요한 질문들
생성된 오디오는 누구 소유인가요?
당신 것입니다 — 지적 재산권과 상업적 권리 100%가 요청자에게 귀속됩니다(약관 제1조). 제품, 광고, 영상, 게임 어디에든 쓰세요. 출처 표기도, 로열티도 영원히 없습니다.
정말 상업적으로 써도 안전한가요?
네. 모델(Kokoro-82M)은 Apache-2.0, 런타임(kokoro-onnx)은 MIT — 모두 상업적 이용을 허용합니다. 라이선스 고지는 모든 응답의 x-license 헤더에 저희가 싣습니다. 컴플라이언스 부담은 API 이쪽 편의 몫입니다.
한국어 보이스가 있나요?
아직 없습니다. 현재 엔진(Kokoro v1.0)은 영어·스페인어·프랑스어·힌디어·이탈리아어·일본어·포르투갈어·중국어 8개 언어를 지원합니다. 한국어 엔진 추가를 검토 중입니다.
보이스 클로닝을 제공하나요?
의도적으로 제공하지 않습니다. 사전 승인된 프리셋 보이스만 노출되며, 스택에 클로닝 코드 자체가 없습니다. 산출물이 법적으로 안전한 큰 이유입니다.
속도 제한은 어떻게 되나요?
크레딧 잔액이 곧 제한입니다 — 1글자에 1크레딧, 요청마다 원자적으로 차감됩니다. 서버 측 합성 실패 시 크레딧은 자동 환불됩니다.
어떤 오디오 포맷을 받나요?
WAV, 24kHz, 16비트 모노 — 어떤 플레이어·파이프라인에서든 바로 재생됩니다. MP3 출력은 로드맵에 있으며, 그 전까진 ffmpeg 한 줄로 변환하면 됩니다.