자주 묻는 질문
TTS API는 무엇인가요?
NaeumBridge는 텍스트를 음성 파일로 변환하는 클라우드 TTS API입니다. POST 요청으로 텍스트를 보내면 mp3, wav 등 형식의 오디오를 반환합니다. OpenAI SDK와 호환되며, base_url만 변경하면 바로 사용 가능합니다. 복잡한 설정 없이 RESTful API로 음성 파일을 생성할 수 있습니다.
목소리는 어떻게 라이선스되나요?
8가지 음성 프리셋은 LibriTTS-R(CC BY 4.0) 및 LibriVox의 퍼블릭 도메인 오디오북 읽기 recordings를 기반으로 합니다. 각 생성된 파일에는 합성 음성을 나타내는 무음의 워터마크가 포함됩니다. 별도의 커스텀 목소리 클로닝이나 감정 태그 기능은 제공되지 않습니다.
데이터는 어떻게 처리되나요?
입력 텍스트는 오디오 생성에만 사용되며 학습에 쓰이지 않습니다. 생성된 오디오는 응답으로 반환되고 저장되지 않습니다. 요금 청구를 위해 요청 시간, 문자 수, 상태 같은 메타데이터만 보관됩니다. 따라서 귀하의 데이터는 안전하게 관리됩니다.
API의 한계는 무엇인가요?
스트리밍, WebSocket, SSML, 커스텀 발음 사전, 커스텀 목소리 클로닝, 감정 태그가 지원되지 않습니다. 모바일 SDK나 WordPress 플러그인도 없습니다. SLA나 가동 시간 보장, 인증서도 없으며, 전화나 실시간 채팅 지원도 제공되지 않습니다. 오직 이메일 지원만 가능합니다.
어떻게 연락하나요?
NaeumBridge는 이메일로만 지원을 제공합니다. 전화 번호나 실시간 채팅 서비스는 없습니다. 문의 사항이나 기술적 문제가 발생하면 공식 연락처 페이지를 통해 이메일로 연락해 주시면 됩니다. 빠른 응답을 위해 상세한 설명을 포함해 주시기 바랍니다.
라이선스는 무엇인가요?
음성 원천은 CC BY 4.0 및 퍼블릭 도메인입니다. 생성된 오디오 파일에는 합성 음성임을 알리는 무음 워터마크가 포함됩니다. 별도의 추가 요금 없이 API를 통해 생성된 오디오를 사용할 수 있습니다. 상업적 사용도 가능합니다.
데이터 정책은 어떻게 되나요?
입력 텍스트는 오디오 생성 외의 목적으로 사용되지 않으며 학습 데이터로 활용되지 않습니다. 생성된 오디오 파일은 서버에 저장되지 않습니다. 요청 시간, 문자 수, 상태 등 요금 청구를 위한 메타데이터만 보관됩니다. 데이터는 안전하게 관리됩니다.
연락처는 어디인가요?
모든 문의는 이메일로 처리됩니다. 전화나 실시간 채팅은 지원되지 않습니다. /contact/ 페이지에서 이메일 주소를 확인하고 문의하실 수 있습니다. 기술 지원이나 계정 관련 문제는 이메일로 보내주시면 담당자가 확인하여 답변 드립니다.
가격 및 결제
NaeumBridge의 TTS API는 100만 자당 $10의 사용량 기반 과금 모델을 따릅니다. 복잡한 월 정액제나 최소 사용량 제한이 없으므로, 소규모 프로젝트나 대용량 처리 모두 비용 효율적입니다. 공백과 구두점도 문자 수에 포함됩니다.
100만 자당 $10
사용량에 따라 유연하게 요금이 부과됩니다. 월 정액제나 최소 사용량이 없습니다.
실패 시 무료
합성 중 오류가 발생하면 요금이 부과되지 않습니다. 실패한 요청에 대한 과금은 전액 환불됩니다.
USDT(TRC-20) 결제
USDT(TRC-20)로만 충전이 가능합니다. 최소 충전 금액은 $5이며, 이체 후 몇 분 내로 자동 크레딧이 적용됩니다.
무료 체험 크레딧
Google 로그인 시 $0.50(약 50,000자)의 체험 크레딧이 제공됩니다. 이메일/비밀번호 계정 생성 시 체험금이 없습니다.
지원 언어
NaeumBridge TTS API는 언어 학습 및 오디오 제작을 위해 설계된 23개 언어를 지원합니다. 영어, 한국어, 중국어 등 주요 언어는 물론 스페인어, 아랍어, 스와힐리어까지 광범위한 커버리지를 제공합니다.
단순히 언어 목록을 넘어, 개발자가 API를 통해 자연스럽게 음성을 생성할 수 있는 기반을 마련합니다. 특정 언어의 발음이나 억양에 대한 복잡한 설정 없이도 일관된 품질을 유지합니다.
23개 언어 지원
아래 23개 언어를 지원합니다. 각 음성은 해당 언어의 자연스러운 발음과 억양을 반영하여 생성됩니다.
지원 언어: Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, Turkish
언어 자동 감지
API는 요청 본문에 language 필드가 지정되지 않으면 입력 텍스트의 문자를 분석하여 언어를 자동으로 감지합니다. 라틴 문자의 텍스트는 기본적으로 영어로 처리되므로, 영어 외의 라틴 문자 언어(예: 프랑스어, 독일어)를 사용할 때는 반드시 language 파라미터를 명시적으로 설정해야 합니다.
지원하지 않는 언어
아래 언어들은 현재 지원되지 않습니다. 베트남어, 인도네시아어, 태국어, 우크라이나어, 루마니아어, 체코어, 벵골어 및 기타 언어는 요청 시 오류를 반환합니다.
- Vietnamese
- Indonesian
- Thai
- Ukrainian
- Romanian
- Czech
- Bengali
음성 및 모델
NaeumBridge의 TTS API는 언어 학습과 오디오 제작에 최적화된 8가지의 명확한 성격을 가진 프리셋 음성을 제공합니다. 각 음성은 LibriTTS-R 데이터셋을 기반으로 한 라이선스된 녹음 음원을 기반으로 제작되었으며, 생성된 모든 오디오 파일에는 합성 음성임을 나타내는 무음수 워터마크가 포함되어 있습니다.
모델은 tts-1과 tts-1-hd 두 가지로 제공되며, 동일한 엔진과 가격을 적용합니다. MP3, WAV, OPUS, FLAC, PCM 등 다양한 오디오 포맷을 지원하여 개발자가 원하는 형식으로 음성을 쉽게 통합할 수 있습니다.
8가지 프리셋 음성
ARIA는 따뜻하고 명확한 내레이터 톤을, NOVA는 밝고 활기찬 스타일을 가집니다. LUNA는 부드러운 스토리텔링에, SAGE는 차분한 안내형 어조로 적합합니다. 남성 음성인 FELIX은 에너지 넘치는 홍보용에, MILO는 친근한 대화체에 적합합니다. ATLAS는 중립적인 뉴스 톤을, ORION은 깊고 다큐멘터리 스타일의 목소리를 제공합니다.
- ARIA: 따뜻하고 명확한 내레이터
- NOVA: 밝고 활기찬 스타일
- LUNA: 부드럽고 스토리텔링
- SAGE: 차분하고 안내형
- FELIX: 에너지 넘치는 홍보
- MILO: 친근하고 대화체
- ATLAS: 중립적이고 뉴스
- ORION: 깊고 다큐멘터리
tts-1 및 tts-1-hd
API는 tts-1과 tts-1-hd 두 가지 모델을 지원합니다. 두 모델은 동일한 엔진을 사용하며 가격도 동일합니다. 필요한 경우 두 모델 중 하나를 선택하여 요청할 수 있습니다.
다양한 오디오 포맷
API는 MP3, WAV, OPUS, FLAC, PCM 등 다양한 오디오 포맷을 지원합니다. response_format 파라미터를 통해 생성할 오디오의 형식을 지정할 수 있습니다. 이는 다양한 개발 환경과 플레이어 호환성을 위해 설계되었습니다.
데이터 정책
NaeumBridge는 생성된 오디오 파일이 아닌 요청 데이터 자체의 처리 원칙을 중시합니다. API로 전송된 입력 텍스트는 오디오 생성 프로세스에만 사용되며, 별도의 학습 데이터로 활용되지 않습니다. 이는 개발자가 민감한 텍스트를 다룰 때 안심하고 사용할 수 있는 기반이 됩니다.
입력 텍스트 비저장
API 요청 시 전송된 텍스트는 음성 합성 엔진에서 바로 처리됩니다. 입력 텍스트는 오디오 생성에만 사용되며 학습 데이터로 활용되지 않습니다. 따라서 텍스트의 프라이버시가 유지됩니다.
생성 오디오 미저장
API 응답을 통해 클라이언트 측으로 전송된 오디오 파일은 NaeumBridge 서버에 저장되지 않습니다. 생성된 오디오는 응답을 통해 반환되며 서버에 저장되지 않습니다. 오디오 파일의 영구 보관은 전적으로 개발자의 책임입니다.
사용량 메타데이터 보관
정확한 과금을 위해 요청 시간, 문자 수, 상태 코드를 메타데이터로 기록합니다. 이 정보는 청구 검증 및 서비스 상태 모니터링에만 사용되며, 텍스트 콘텐츠나 오디오 데이터와 연결되지 않습니다.

API 사용 가이드
NaeumBridge API는 OpenAI의 speech 엔드포인트와 동일한 JSON 구조를 사용합니다. base_url을 https://api.be888.info/v1로 설정하고, 표준 OpenAI SDK를 그대로 사용하시면 됩니다. 별도 SDK 설치 없이 HTTP 라이브러리나 Python, Node.js 라이브러리로 빠르게 연동할 수 있습니다.
API 키는 /get-api-key/ 페이지에서 발급받으세요. 인증 헤더에 Bearer 토큰을 포함해 요청하시면 됩니다.
OpenAI SDK 호환
POST /v1/audio/speech 엔드포인트는 OpenAI의 요청 형식과 완벽하게 호환됩니다. base_url을 변경하고 동일한 키를 사용하시면 별도의 파싱 로직 없이 오디오 파일을 받을 수 있습니다.
- Python, Node.js 등 주요 언어 SDK 지원
- RESTful JSON 구조로 직관적인 구현 가능
Rate Limit 정보
API 키당 분당 60건의 요청이 허용됩니다. 초기에는 분당 10건으로 제한되며, 첫 충전 후 제한이 해제됩니다.
대용량 텍스트는 4096자 단위로 분할하여 처리해야 합니다. 요청은 순차적으로 처리되므로 부하 시 큐에 대기할 수 있습니다.
- 60 req/min (충전 후)
- 10 req/min (초기)
- 4096자 제한 준수
오류 처리 방식
합성 실패 시 과금이 발생하지 않습니다. 네트워크 오류나 서버 오류 시 자동으로 크레딧이 반환되므로 안심하고 사용할 수 있습니다.
4xx 에러는 파라미터 오류, 5xx 에러는 서버 문제로 구분하여 처리하세요.
- 실패 시 무료
- 자동 크레딧 반환
지원 및 연락처
NaeumBridge의 지원은 이메일로만 진행됩니다. 전화나 실시간 채팅은 제공되지 않으며, 기술적 문의나 계정 관련 문제는 이메일을 통해 해결할 수 있습니다.
자주 묻는 질문(FAQ) 페이지를 통해 일반적인 문제를 먼저 확인하세요. 그 외의 구체적인 질문은 아래 연락처로 문의해 주세요.
이메일 지원
모든 문의는 이메일로 처리됩니다. 기술 지원이나 결제 문의 시 API 키 말두 문자를 함께 알려주시면 더 빠르게 응답해 드립니다.
FAQ 확인
자주 묻는 질문 페이지에서 무료 체험 크레딧, 과금 정책, 언어 지원 여부 등을 먼저 확인하세요. 대부분의 기술적 문제는 FAQ에서 해결됩니다.
계정 관리
계정 관리는 /get-api-key/ 페이지에서 직접 가능합니다. API 키 발급, 비밀번호 변경, 잔액 확인은 모두 웹 대시보드에서 처리됩니다.
자주 묻는 질문
문서 하단의 FAQ는 자주 묻는 질문을 정리한 것입니다. 계정 생성부터 오류 처리까지 핵심 정보를 빠르게 확인하세요.
더 명확한 안내가 필요하면 하단 연락처로 문의해 주세요. 이메일로 신속하게 답변 드립니다.
무료 체험은 어떻게 받나요?
Google 계정으로 로그인하면 $0.50의 무료 체험 크레딧이 제공됩니다. 약 50,000자를 생성할 수 있으며, 7일 동안 유효합니다. 이메일과 비밀번호로 회원가입한 경우 체험 크레딧이 기본 제공되지 않습니다.
- Google 로그인 시 $0.50 크레딧 지급
- 최대 50,000자 생성 가능
- 소유 기간: 가입일로부터 7일
지원하지 않는 언어는?
아랍어, 중국어, 영어 등 23개 언어를 지원합니다. 베트남어, 인도네시아어, 태국어, 우크라이나어, 루마니아어, 체코어, 벵골어 등은 아직 지원되지 않습니다.
지원 목록에 없는 언어로 텍스트를 입력하면 오류가 발생할 수 있습니다. 정확한 언어 코드를 명시하면 더 안정적인 결과를 얻을 수 있습니다.
- 지원 언어: 23개
- 미지원 언어: 베트남어, 태국어 등
오류 발생 시 과금?
음성 합성 중 오류가 발생하면 요금이 부과되지 않습니다. 실패한 요청에 대해서는 요금이 전액 환불됩니다.
정상적으로 완료된 요청에만 요금이 청구되며, 100만 자당 $10의 요금이 적용됩니다.
- 실패 요청: 무료
- 성공 요청: $10 / 100만 자
API 키는 어떻게 발급받나요?
홈페이지의 /get-api-key/ 페이지에서 Google 또는 이메일 회원가입을 통해 API 키를 발급받을 수 있습니다. 발급된 키는 계정 관리 페이지에서 확인할 수 있습니다.
API 키는 하나의 계정에 하나만 활성화됩니다. 새로운 키를 발급하면 기존 키는 즉시 무효화됩니다.
- Google 또는 이메일 회원가입
- /get-api-key/ 페이지에서 발급
- 키 재발급 시 기존 키 즉시 정지
8개 음성 듣기
아래의 각 샘플은 동일한 문장을 이 API로 생성한 것입니다. 복잡한 문장 구조나 새로운 어휘를 학습할 때, 아리아의 선명하고 안정된 발음은 이해도를 높이는 데 큰 도움이 됩니다.
23개 언어
모든 음성은 이 언어들을 구사합니다.
