자주 묻는 질문
TTS 변환이란 무엇인가요?
TTS 변환은 텍스트를 음성 파일로 변환하는 API 서비스입니다. JSON 요청을 보내면 mp3, wav 등 형식의 오디오 파일을 받습니다. 최대 4,096자까지 처리하며, 긴 문장은 여러 요청으로 나누어 생성할 수 있습니다. 생성된 오디오는 응답으로 즉시 반환되며, 별도의 저장 없이 사용자의 시스템으로 전달됩니다.
법률 문서에 적합한 음성 목소리는 무엇인가요?
법률 문서에는 명확한 발음이 중요한 'sage'(차분한 안내형)나 'atlas'(중립적인 뉴스형)가 적합합니다. 'aria'나 'nova'는 명확한 내레이션과 밝은 톤으로 복잡한 용어도 잘 전달합니다. 모든 음성은 23개 언어를 지원하므로, 법률 용어의 정확한 발음을 위해 언어 코드를 명시적으로 설정하는 것이 좋습니다.
API 연동이 어려운 경우 어떻게 해야 하나요?
요청 구조가 OpenAI 스피치 엔드포인트와 동일하여 공식 OpenAI SDK를 사용할 수 있습니다. base_url을 https://api.gen189.info/v1로 변경하고 API 키를 설정하면 됩니다. /get-api-key/ 페이지에서 curl 예시와 함께 요청 형식을 확인할 수 있으며, HTTP 요청을 직접 보내는 것으로도 쉽게 연동할 수 있습니다.
지원되는 언어는 어떤 것들이 있나요?
영어, 한국어, 일본어, 중국어, 스페인어, 프랑스어, 독일어 등 총 23개 언어를 지원합니다. 모든 음성은 모든 언어를 구사합니다. 언어를 지정하지 않으면 스크립트에 따라 추측되나, 비영어권 라틴 문자 텍스트는 language 파라미터를 명시적으로 설정해야 합니다. 베트남어, 태국어 등 미지원 언어는 포함되지 않습니다.
오디오 파일의 형식은 어떻게 선택하나요?
response_format 파라미터를 통해 mp3, wav, opus, flac, pcm 중 하나를 선택할 수 있습니다. 파일 크기와 품질 요구사항에 따라 적합한 형식을 선택하세요. mp3는 일반적인 사용에 적합하며, wav와 flac은 손실 없는 품질이 필요할 때 권장됩니다. pcm은 원시 데이터로 처리 속도가 빠른 환경에 적합합니다.
API 호출 한도는 어떻게 되나요?
키당 분당 60회 요청 한도가 있습니다. 첫 충전 전에는 분당 10회로 제한됩니다. 요청은 순차적으로 처리되므로 부하가 있을 경우 대기열에 진입할 수 있습니다. 긴 텍스트는 4,096자 단위로 나누어 여러 요청을 보내야 하며, 각 요청은 독립적으로 처리되어 오디오 파일로 반환됩니다.
가격은 어떻게 계산되나요?
100만 문자당 $10의 요금이 부과됩니다. 공백과 구두점도 문자 수에 포함됩니다. 실패한 요청은 요금이 부과되지 않으며, 요금이 전액 환불됩니다. Google 로그인 시 무료 체험으로 $0.50 크레딧(약 50,000자)을 제공하며, 이메일 가입 시에는 제공되지 않습니다. 월 구독이나 최소 사용량이 없으며, 사용량에 따라만 요금이 발생합니다.
충전은 어떻게 하나요?
TRON 네트워크(TRC-20)의 USDT로만 충전할 수 있습니다. 최소 충전 금액은 $5이며, 이체 후 수분 내에 자동으로 잔액이 충전됩니다. 신용카드나 PayPal은 지원되지 않으며, 세금 계산서 발행도 없습니다. 충전된 잔액은 만료일이 없으며, 언제든지 사용 가능합니다. 충전 내역은 대시보드에서 확인할 수 있습니다.
데이터는 어떻게 처리되나요?
입력 텍스트는 오디오 생성에만 사용되며 학습 데이터로 사용되지 않습니다. 생성된 오디오는 응답을 통해 반환되며 서버에 저장되지 않습니다. 청구 및 과금을 위해 요청 시간, 문자 수, 상태 등의 메타데이터는 보관됩니다. 데이터는 API 호출 목적 외에는 사용되지 않으며, 별도의 추적이나 분석에 활용되지 않습니다.
SSML을 지원하나요?
SSML을 지원하지 않습니다. 텍스트는 단순 문자열로 전달되며, SSML 태그를 통한 속도나 억양 제어가 불가능합니다. 속도 조절은 speed 파라미터(0.25~4.0)로만 가능합니다. 복잡한 발음이나 휴지 시간 조절이 필요한 경우, 텍스트 자체에 구두점이나 기호를 적절히 배치하여 처리해야 합니다.
스트리밍이 가능한가요?
스트리밍을 지원하지 않습니다. 전체 텍스트가 처리된 후 오디오 파일이 반환됩니다. WebSocket이나 실시간 부분 오디오 전송이 불가능합니다. 대역폭이 제한된 환경이나 실시간 상호작용이 필요한 경우, 로컬 플레이어로 파일을 재생하는 방식으로 활용해야 합니다.
커스텀 보이스 클로닝이 가능한가요?
커스텀 보이스 클로닝을 제공하지 않습니다. 8가지 사전 정의된 음성 중 하나를 선택해야 합니다. 사용자가 직접 음성을 업로드하거나 맞춤형 음성을 디자인할 수 있는 기능은 없습니다. LibriTTS-R(CC BY 4.0) 및 LibriVox 퍼블릭 도메인 오디오북 읽기 데이터를 기반으로 합니다.
전화 지원이 가능한가요?
전화 지원을 제공하지 않습니다. 모든 문의는 이메일로만 처리됩니다. 실시간 채팅이나 전화 상담 창구가 없으므로, 기술적 문제나 계정 관련 문의는 이메일을 통해 접수해야 합니다.
공인 인증서가 있나요?
SOC 2, HIPAA, GDPR 인증서를 제공하지 않습니다. 서비스 수준 계약(SLA)이나 가동 시간 보장도 없습니다. 엔터프라이즈 계약이나 온프레미스 설치 옵션도 없습니다.
첫 번째 요청
curl
curl https://api.gen189.info/v1/audio/speech \
-H "Authorization: Bearer $TTS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"tts-1","voice":"aria","input":"Hello from the API.","response_format":"mp3"}' \
--output hello.mp3법률 문서에 특화된 음성 합성
법률 문서의 복잡한 문장 구조도 명확하게 전달합니다. 긴 문서의 효율적인 처리 방식과 법률 용어에 최적화된 음성 엔진을 통해 접근성을 높입니다.
명확한 발음과 자연스러운 속도 조절
0.25부터 4.0까지 속도 범위를 조정할 수 있어, 복잡한 조항도 듣기 편하게 만들 수 있습니다. 음성 엔진은 정확한 발음을 유지하며 자연스러운 속도를 제공합니다.
긴 문서의 효율적인 처리 방식
한 번에 4096자까지 입력 가능합니다. 긴 법률 문서의 경우, 여러 부분으로 나누어 오디오 파일을 생성한 후 연결하는 방식으로 처리됩니다. 이는 긴 문서의 효율적인 처리 방식입니다.
법률 용어에 최적화된 음성 엔진
8가지 preset 음성 중 하나를 선택하여 사용합니다. aria, nova, luna, sage, felix, milo, atlas, orion은 법률 문서의 전문성과 API 기술의 교차점에서 명확한 발음을 보장합니다.
지원 언어 및 음성
23개 언어를 지원하며, 한국어는 물론 영어, 중국어, 일본어 등 주요 법률 업무 언어를 모두 다룹니다. 모든 음성은 모든 언어를 구사하므로, 특정 언어 전용 모델을 선택할 필요 없이 통합된 인터페이스로 관리할 수 있습니다.
23개 언어 지원 (한국어 포함)
아랍어부터 터키어까지 23개 언어를 지원합니다. 한국어, 영어, 중국어 등 법률 문서에서 자주 사용되는 언어를 포함하여, 전 세계 법률 데이터의 접근성을 높입니다. 지원되지 않는 언어(베트남어, 태국어 등)는 명시적으로 배제됩니다.
- 아랍어, 중국어, 영어, 프랑스어, 독일어, 일본어, 한국어, 스페인어 등 23개 언어
- 모든 음성이 모든 언어를 구사
8가지 preset 음성 (여자/남자)
4명의 여성(Aria, Nova, Luna, Sage)과 4명의 남성(Felix, Milo, Atlas, Orion) 보이스를 제공합니다. Aria는 따뜻하고 명확한 내레이터, Atlas는 중립적인 뉴스 성격의 음정으로 복잡한 법률 용어 전달에 적합합니다. 모든 음성은 라이선스된 녹음 데이터를 기반으로 합니다.
- 여성: Aria, Nova, Luna, Sage
- 남성: Felix, Milo, Atlas, Orion
언어별 최적화된 발음 설정
기본적으로 입력된 텍스트의 문자를 분석해 언어를 자동 감지합니다. 예를 들어 라틴 문자는 영어로 처리됩니다. 그러나 한국어 법률 문서와 같이 특정 언어의 정확한 발음이 필요할 때는 요청 시 language 파라미터에 ISO 코드를 명시적으로 설정해야 합니다.
간단한 API 연동
API 엔드포인트는 OpenAI Speech 엔드포인트와 동일한 요청 구조를 따릅니다. base_url만 https://api.gen189.info/v1로 변경하면 기존 OpenAI SDK를 바로 사용할 수 있어 연동 시간이 단축됩니다.
OpenAI SDK 호환 구조
POST https://api.gen189.info/v1/audio/speech 엔드포인트를 통해 텍스트를 전송하면 오디오 파일이 반환됩니다. 헤더에 Authorization: Bearer 키를 추가하면 인증이 완료됩니다.
- GET /v1/voices: 음성 목록 조회
- GET /v1/models: 모델 정보 조회
빠른 API 키 발급 절차
사이트의 /get-api-key/ 페이지에서 Google 또는 이메일로 가입하세요. 가입 시 즉시 API 키가 생성되며, 기존 키는 새 키 발행 시 동시에 무효화됩니다.
간단한 curl 테스트 예시
아래 명령어로 즉시 테스트할 수 있습니다. 모델은 'tts-1' 또는 'tts-1-hd'를 사용하며, 최대 4096자까지 입력 가능합니다.
curl -X POST https://api.gen189.info/v1/audio/speech \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"tts-1","input":"법률 문서 테스트입니다.","voice":"nova","response_format":"mp3","speed":1.0}'
가격 정책 및 결제
저희 TTS API는 복잡한 법률 문서의 특성상 문자 수 기반 과금 모델을 적용합니다. 100만 자당 $10, 즉 1,000자당 $0.01의 정산이 이루어지며, 공백과 구두점도 문자 수에 포함됩니다. 이는 긴 계약서나 판례문처럼 텍스트량이 많을 때 비용 예측을 쉽게 해줍니다.
문자 수 기반 과금 모델
계산은 요청된 텍스트의 총 문자 수를 기준으로 합니다. 4,096자 제한을 넘을 경우 분할 요청을 통해 처리되므로, 전체 길이에 따른 과금이 자연스럽게 적용됩니다.
실패 시 환불 보장
합성 과정에서 오류가 발생하여 오디오 파일을 반환하지 못하면, 해당 요청에 대한 금액은 전액 환불됩니다. 성공적으로 생성된 파일에 대해서만 과금이 발생하므로, 불필요한 비용 부담이 없습니다.
USDT(TRC-20) 간편 충전
카드는 물론 PayPal나 구독제 없이, TRON 네트워크(TRC-20)의 USDT로만 충전이 가능합니다. 최소 $5부터 충전이 가능하며, 송금 후 몇 분 안에 잔액이 자동으로 반영됩니다.
월 정산이나 부가세 고지서가 필요 없는 단순한 구조로, 개발자가 직접 잔액을 관리할 수 있습니다. 충전된 잔액은 유효 기간 없이 영구적으로 사용 가능합니다.
기술적 한계 및 특징
이 API는 실시간 스트리밍이나 SSML, 발음 사전과 같은 고급 기능을 제공하지 않습니다. 텍스트를 입력하면 전체 처리 후 오디오 파일이 반환되며, 복잡한 구문보다는 명확한 문장 단위의 생성에 최적화되어 있습니다.
스트리밍 및 SSML 미지원
스트리밍, SSML, 사용자 정의 음성 클로닝, 감정 태그 등의 기능이 없습니다. 텍스트는 최대 4,096자까지 한 번에 입력할 수 있으며, 긴 문서는 여러 번 나누어 요청해야 합니다. 이 구조는 안정적인 파일 생성과 간편한 연동에 중점을 둡니다.
- 스트리밍 및 WebSocket 지원 없음
- SSML 또는 발음 사전 미지원
- 사용자 정의 음성 클로닝 불가
배치 처리 및 큐 시스템
요청은 하나씩 순차적으로 처리됩니다. 부하가 걸릴 경우 요청이 큐에 대기할 수 있으며, 긴 문서의 경우 각 조각을 따로 생성한 후 이어붙여야 합니다. 짧은 문장은 몇 초, 긴 문서는 실시간 속도에 가깝게 생성됩니다.
데이터 사용 및 보관 정책
입력 텍스트는 오디오 생성에만 사용되며 학습 데이터로 활용되지 않습니다. 생성된 오디오는 응답으로 제공되며 서버에 저장되지 않습니다. 청구 및 과금을 위해 요청 시간, 문자 수, 상태와 같은 메타데이터만 보관됩니다.

주요 사용 사례
API를 활용하여 복잡한 법률 문서를 오디오로 변환하면 접근성이 크게 향상됩니다. 계약서나 판례문을 텍스트가 아닌 음성으로 제공함으로써, 시각적 정보에 의존하지 않는 사용자들도 법률 정보를 쉽게 이해하고 활용할 수 있습니다.
계약서 오디오 버전 제작
긴 계약 조건이나 조항을 음성 파일로 변환하여 모바일 앱이나 웹 서비스에 통합할 수 있습니다. 최대 4,096자까지의 텍스트를 처리할 수 있으며, 속도를 조절하여 핵심 내용을 명확히 전달합니다.
- 긴 문서의 분할 처리 및 연결 가능
- MP3 또는 WAV 형식으로 간편한 배포
판례문 accessibility 제공
판례문 전문을 음성으로 변환하여 시각 장애인이나 청각 학습자에게 적합한 형태로 제공합니다. 한국어 및 22개 다른 언어를 지원하여 다양한 배경의 사용자에게 명확한 발음과 자연스러운 속도를 보장합니다.
법률 상담 자동화 시스템
상담 자동화 시스템에 TTS API를 연결하여 상담 결과를 실시간으로 음성으로 전달할 수 있습니다. API 호출 시 발생할 수 있는 큐 대기 시간을 고려하여 사용자 경험을 최적화할 수 있습니다.
개발자를 위한 가이드
API 호출 시 발생하는 일반적인 오류와 처리 방법을 알아봅니다. 실패한 요청은 요금이 부과되지 않으며, 오류 메시지에 따라 요청 파라미터를 확인하세요.
속도 조절과 형식 선택은 생성된 오디오의 품질과 용량에 직접적인 영향을 미칩니다. 개발 환경에 맞는 설정을 적용해 효율성을 높이세요.
에러 코드 및 처리 방법
요청이 실패할 경우 요금이 전액 환불됩니다. 429 에러는 분당 60회 제한(초기 10회)을 의미하며, 대기열 처리로 인해 지연될 수 있습니다.
문자 수 제한(4096자)을 초과하면 오류가 발생합니다. 긴 문서는 여러 번 나누어 요청한 후 오디오 파일을 연결해야 합니다.
- 429 Too Many Requests: 분당 요청 수 초과
- 400 Bad Request: 잘못된 파라미터 또는 문자 수 초과
- 503 Service Unavailable: 일시적 과부하 (대기열 상태)
속도 조절 파라미터 설명
speed 파라미터는 0.25에서 4.0까지 설정할 수 있습니다. 기본값은 1.0이며, 법적 문서 읽기 속도에 맞춰 조정하세요.
속도를 높이면 처리 시간이 단축되지만 명확성이 떨어질 수 있습니다. 짧은 문장은 수 초, 긴 문물은 실시간 속도에 가깝게 생성됩니다.
- 0.25: 매우 느린 읽기 (세부 설명용)
- 1.0: 기본 속도 (표준 발음)
- 2.0: 빠른 읽기 (요약 청취용)
형식 선택 (MP3, WAV 등)
response_format은 mp3, wav, opus, flac, pcm 중 선택 가능합니다. mp3는 용량이 작아 저장에 유리하며, wav는 무손실 품질을 제공합니다.
생성된 오디오는 응답 내에서 직접 반환되며 서버에 저장되지 않습니다. 필요 시 클라이언트 측에서 적절한 형식으로 저장해야 합니다.
- mp3: 압축 형식 (저장 용량 절약)
- wav: 무손실 형식 (고품질)
- opus: 고효율 압축
자주 묻는 질문 요약
복잡한 법률 문서의 발음을 정확하게 처리하기 위해 언어 감지 및 API 한도를 명확히 이해해야 합니다.
지원 언어와 형식, 제한 사항을 확인하여 효율적인 API 연동을 준비하세요.
언어 자동 감지 기능
언어 필드를 비워두면 스크립트 기반 언어가 추론됩니다. 라틴 문자의 기본값은 영어이므로, 한국어 법률 문서나 기타 라틴 문자 기반 언어를 사용할 경우 반드시 language 파라미터를 명시해야 정확한 발음이 보장됩니다. 예를 들어, 한국어 텍스트에 언어를 지정하지 않으면 영어 발음으로 변환될 수 있습니다.
- 지원 언어: 23개 (한국어 포함)
- 미지원 언어: 베트남어, 인도네시아어, 태국어 등
- 기본값: 라틴 문자는 영어로 추론
오디오 파일 형식 선택
response_format 파라미터를 통해 mp3, wav, opus, flac, pcm 중 하나를 선택할 수 있습니다. mp3는 저장 공간을 절약하고, wav는 높은 품질이 필요할 때 적합합니다. 법률 문서의 장기 보관이나 고해상도 분석이 필요한 경우 FLAC을 권장하며, 스트리밍이나 실시간 처리는 지원하지 않습니다.
- 지원 형식: mp3, wav, opus, flac, pcm
- 스트리밍/WS 미지원
- SSML 미지원
API 한도 및 제한 사항
한 번의 요청당 입력 텍스트는 최대 4096자까지 가능합니다. 4096자를 초과하는 긴 법률 문서의 경우, 클라이언트에서 여러 부분으로 나누어 요청한 후 오디오 파일을 연결해야 합니다. API 키당 분당 60회 요청 한도가 있으며, 과금 단위인 100만 자당 10달러의 요금이 적용됩니다.
실패한 요청의 경우 요금이 전액 환불됩니다. API 키는 계정당 하나만 활성이며, 새 키 발급 시 이전 키는 즉시 정지됩니다. 외부 SDK 또는 플러그인을 제공하지 않으며, 오픈AI SDK의 base_url 변경을 통해 연동할 수 있습니다.
- 최대 입력 길이: 4096자
- 요청 제한: 분당 60회
- 과금 단위: 100만 자당 $10
문의 및 지원
HyeongSeo는 전화나 실시간 채팅 대신 이메일을 통해 지원하고 있습니다. 기술적 문의나 API 관련 질문은 [email protected]로 보내주세요. 답변은 빠르게 처리됩니다.
다른 섹션에서 다루지 않은 상세한 기술 문서나 서비스 이용약관 링크는 아래에서 바로 확인하실 수 있습니다.
이메일 지원 안내
모든 문의는 이메일로 접수됩니다. 지원팀에서는 이메일로만 소통하며, 별도의 전화 번호나 라이브 채팅은 운영하지 않습니다. API 키 발급 문제나 과금 문의도 이메일로 가능합니다.
- 이메일: [email protected]
- 응답 시간: 영업일 기준 신속 처리
- 운영: 이메일 전용 지원
기술 문서 링크
API 엔드포인트, 파라미터 설명, 에러 코드 처리 방법을 상세히 안내하는 기술 문서는 /docs/ 페이지에서 확인하실 수 있습니다. OpenAI SDK 호환 구조에 대한 가이드도 포함되어 있습니다.
- /docs/ 접속
서비스 약관 링크
서비스 이용 조건, 데이터 처리 정책, 환불 규정 등 공식적인 내용은 /about/ 페이지의 서비스 약관에서 확인하실 수 있습니다.
- /about/ 접속
8개 음성 듣기
아래의 각 샘플은 동일한 문장을 이 API로 생성한 것입니다. 실시간성이 필요한 대시보드 알림보다는, 문서 생성 후 다운로드하거나 저장하는 워크플로우에 최적화되어 있습니다.
23개 언어
모든 음성은 이 언어들을 구사합니다.
