자주 묻는 질문
텍스트 음성 변환기는 유튜브 영상 제작에 어떻게 활용되나요?
API를 통해 스크립트를 오디오 파일로 변환해 유튜브 영상 제작에 활용할 수 있습니다. 최대 4096자까지 텍스트를 입력하고 mp3, wav 등 다양한 형식으로 오디오를 받을 수 있습니다. 긴 스크립트는 분할 후 합성하여 사용할 수 있어 효율적인 콘텐츠 제작이 가능합니다.
PlayMB99의 API는 OpenAI SDK와 완전히 호환되나요?
요청 형식이 OpenAI 스피치 엔드포인트와 동일하여 공식 OpenAI SDK와 호환됩니다. base_url을 https://api.playmb99.com/v1로 변경하고 API 키를 설정하면 바로 사용할 수 있습니다. 별도의 전용 SDK나 라이브러리 설치 없이 기존 코드를 활용할 수 있습니다.
유튜브 영상에서 상업적으로 사용 가능한 음성인가요?
음성은 LibriTTS-R(CC BY 4.0) 및 LibriVox 퍼블릭 도메인 녹음 기반입니다. 생성된 오디오 파일에는 합성 음성을 나타내는 비가청 워터마크가 포함됩니다. 저작권 문제는 발생하지 않으나, 특정 인물 모방은 제공되지 않으며 일반적인 상업적 사용에 적합합니다.
지원되는 보이스는 총 몇 개이며, 어떤 특징이 있나요?
총 8가지 보이스를 지원합니다. 아리아, 노바, 루나, 세이지 등 여성 보이스와 펠릭스, 밀로, 아틀라스, 오라이온 등 남성 보이스가 있습니다. 각각 내러티브, 업비트, 스토리텔링, 뉴스 등 다양한 톤과 특징을 가지고 있어 콘텐츠 성격에 맞게 선택할 수 있습니다.
지원 언어는 무엇이며 한국어는 포함되어 있나요?
한국어를 포함해 총 23개 언어를 지원합니다. 아라비아어, 중국어, 영어, 프랑스어, 독일어, 일본어 등을 비롯해 한국어가 포함되어 있습니다. 모든 보이스는 모든 지원 언어를 구사할 수 있으며, 언어 코드를 명시하면 더 정확한 발음으로 생성됩니다.
API 요청 시 텍스트 길이 제한은 어떻게 되나요?
요청당 최대 4096자까지 텍스트를 입력할 수 있습니다.spaces와 구두점도 문자 수에 포함됩니다. 4096자를 초과하는 긴 텍스트의 경우, 여러 부분으로 분할하여 오디오를 생성한 후 연결하여 사용할 수 있습니다.
API 호출이 실패했을 때 요금은 어떻게 되나요?
합성 과정 중 오류가 발생하여 요청이 실패한 경우, 해당 요청에 대한 요금은 전액 환불됩니다. 성공적으로 오디오가 생성된 경우에만 요금이 부과되며, 실패 시에는 차액 없이 원금이 반환되므로安心して 사용할 수 있습니다.
충전금은 어떻게 결제하며, 최소 금액은 얼마인가요?
USDT(TRC-20) 트론 네트워크를 통해 충전할 수 있습니다. 최소 충전 금액은 $5이며, 전송 후 몇 분 내에 잔액이 자동으로 충전됩니다. 신용카드, PayPal, 구독형 요금제는 제공되지 않으며, 잔액은 만료 기한 없이 영구적으로 유지됩니다.
API 키는 얼마나 자주 변경할 수 있나요?
계정당 하나의 활성 키를 가지며, 필요할 때 언제든지 새 키를 발급할 수 있습니다. 새 키가 생성되면 이전 키는 즉시 무효화됩니다. 보안 강화나 키 분실 시 즉시 대체하여 사용할 수 있습니다.
생성된 오디오 파일에는 워터마크가 있나요?
네, 생성된 모든 오디오 파일에는 합성 음성임을 나타내는 비가청 워터마크가 포함되어 있습니다. 이는 파일이 AI로 생성되었음을 식별할 수 있도록 하기 위함입니다. 청각적으로 뚜렷하게 드러나지 않지만 기술적으로 추적 가능한 형태로 삽입됩니다.
입력한 텍스트는 학습 데이터로 사용되나요?
아니요. 입력한 텍스트는 오디오 생성 목적에만 사용되며 학습 데이터로 저장되거나 활용되지 않습니다. 생성된 오디오도 응답으로 반환된 후 서버에 저장되지 않습니다. 요청 시간, 문자 수, 상태 등 청구용 메타데이터만 유지됩니다.
유튜브 크리에이터에게 적합한 요금제는 무엇인가요?
월 정액제 없이 문자 수 기반 과금 모델을 제공합니다. 100만 문자당 $10이며, 실패 시 무료입니다. Google 로그인 시 $0.50(약 5만 문자) 무료 체험을 제공하므로, 크리에이터는 부담 없이 시작해 볼 수 있습니다.
에이전시에서 여러 계정을 관리할 수 있나요?
네, 각 사이트별로 독립적인 계정을 생성할 수 있습니다. 에이전시에서는 클라이언트 또는 프로젝트별로 별도 계정을 관리하며, 각 계정마다 독립적인 API 키와 잔액을 가질 수 있어 효율적인 리소스 분배가 가능합니다.
기술 지원은 어떤 채널로 제공되나요?
이메일 지원만 제공됩니다. 전화나 라이브 채팅, SLA, uptime 보장 등은 제공되지 않습니다. 기술 문의나 문제 해결은 이메일을 통해 이루어지며, 빠른 응답을 위해 상세한 오류 정보와 함께 문의하는 것이 좋습니다.
첫 번째 요청
curl
curl https://api.playmb99.com/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.mp3API로 만드는 유튜브 콘텐츠 워크플로우
SungVoice API를 사용하면 대본을 텍스트로 입력하고 즉시 오디오 파일을 받을 수 있습니다. POST 요청 하나로 mp3, wav, opus 등 여러 포맷을 지원하며, 최대 4096자까지 한 번에 처리할 수 있습니다. 긴 대본은 자동으로 분할되어 합성됩니다.
대본 자동 음성 합성 파이프라인
텍스트를 입력하면 합성 엔진이 즉시 오디오를 생성합니다. 실패 시 요금이 부과되지 않으므로 안정적으로 파이프라인을 구축할 수 있습니다. 1초당 약 25자의 처리 속도로 실시간에 가까운 생성이 가능합니다.
에이전시용 대량 생성 자동화
에이전시 워크플로우에 맞게 계정당 하나의 API 키를 관리할 수 있습니다. 분당 60회 요청 제한 내에서 스크립트를 통해 대량 생성을 자동화하세요. USDT(TRC-20)로 즉시 충전하여 연속적인 작업이 가능합니다.
OpenAI SDK 호환 인터페이스
기존 OpenAI SDK의 base_url만 변경하면 바로 사용 가능합니다. tts-1 또는 tts-1-hd 모델을 선택하고 voice 파라미터로 8가지 프리셋 중 원하는 음성을 지정하세요. 별도의 SDK 설치 없이 HTTP 요청으로 통합이 완료됩니다.
지원 언어 및 보이스 프리셋
SungVoice는 영어를 포함한 23개 언어를 지원합니다. 대본의 스크립트 기반으로 언어가 자동 감지되지만, 라틴 문자를 사용한 비영어권 언어의 경우 정확한 발음을 위해 language 매개변수를 명시적으로 설정해야 합니다. 베트남어, 인도네시아어 등은 현재 지원되지 않습니다.
23개 언어 지원 (영어, 한국어 포함)
아라비아어, 중국어, 프랑스어, 독일어, 힌디어, 일본어, 한국어, 스페인어 등 전 세계 주요 언어를 포괄합니다. 특정 언어의 language 코드를 지정하지 않으면 라틴 문자는 기본값으로 영어로 처리되므로, 비영어권 언어 대본 생성 시 language 코드를 설정해야 자연스러운 발음을 얻을 수 있습니다.
- 지원 언어: 아라비아어, 중국어, 덴마크어, 네덜란드어, 영어, 핀란드어, 프랑스어, 독일어, 그리스어, 히브리어, 힌디어, 이탈리아어, 일본어, 한국어, 말레이어, 노르웨이어, 폴란드어, 포르투갈어, 러시아어, 스페인어, 스와힐리어, 스웨덴어, 터키어
- 비지원 언어: 베트남어, 인도네시아어, 태국어, 우크라이나어, 루마니아어, 체코어, 벵골어 등
8가지 전문 보이스 프리셋
LibriTTS-R 데이터셋과 LibriVox 오디오북을 기반으로 한 8가지 보이스를 제공합니다. 여성 보이스로는 따뜻한 내레이터인 aria, 밝은 nova, 부드러운 luna, 차분한 sage가 있으며, 남성 보이스로는 에너지 넘치는 felix, 대화체 Milo, 중립적인 atlas, 다큐멘터리용 Orion이 있습니다.
- Female: aria, nova, luna, sage
- Male: felix, milo, atlas, orion
- 모든 보이스는 23개 언어를 모두 지원
언어별 최적화 음성 선택 가이드
유튜브 콘텐츠의 성격에 따라 보이스를 선택하세요. 예를 들어, 설명성 콘텐츠에는 sage나 milo가 적합하며, 프로모션 영상에는 felix나 nova가 효과적입니다. 모든 보이스는 모든 지원 언어를 구사하므로, 언어와 상관없이 콘텐츠 톤에 가장 부합하는 음성을 선택할 수 있습니다.
유튜브 크리에이터를 위한 가격 정책
문자 수 기반 투명 과금으로 비용을 정확히 관리하세요. 100만 문자당 10달러, 즉 1,000자당 0.01달러의 명확한 가격 정책을 따릅니다. 공백과 구두점도 문자 수에 포함되므로 대본 분량에 따라 비용을 쉽게 예측할 수 있습니다.
문자 수 기반 투명 과금
유튜브 콘텐츠 제작 시 예상 비용을 정확히 산출할 수 있습니다. 월별 구독료나 최소 사용량 제한이 없으므로, 사용량에 따라 비용이 계산됩니다.
- 100만 문자당 $10 ($0.01/1,000자)
- 공백 및 구두점 포함 과금
- 월정액 또는 최소 사용량 없음
실패 시 무료 환불 정책
음성 합성 중 오류가 발생하면 해당 요청에 대한 과금이 완전히 환불됩니다. 실패한 요청은 크레딧이 차감되지 않으므로, 안정적인 파이프라인 구축에 유리합니다.
- 합성 실패 시 전액 환불
- 과금 오류 없음
USDT(TRC-20) 즉시 충전
USDT(TRC-20)를 통해 최소 $5 이상 충전 시 자동으로 잔액이 추가됩니다. 신용카드나 PayPal 없이도 빠르게 결제를 진행할 수 있으며, 잔액은 만료일이 없습니다.
에이전시 워크플로우에서 결제 프로세스를 단순화하여 효율성을 높일 수 있습니다.
- USDT(TRC-20) 전용 충전
- 최소 $5 이상 충전
- 잔액 만료일 없음
기술적 특징과 제한 사항
SungVoice API는 단일 요청당 최대 4,096자의 텍스트를 처리합니다. 유튜브 대본이 이 한도를 초과할 경우, 클라이언트 측에서 분할 요청을 보내고 생성된 오디오 파일을 연결하여 전체 음성 파이프라인을 구축할 수 있습니다.
모든 생성된 오디오 파일에는 합성 음성임을 나타내는 비가청 워터마크가 내장됩니다. 이를 통해 콘텐츠의 원천을 식별할 수 있으며, 저작권 분쟁 시 합성 오디오임을 명확히 하는 데 활용됩니다.
4096자 제한 및 분할 처리
API 엔드포인트는 한 번에 최대 4,096자까지만 수신합니다. 긴 대본의 경우, 텍스트를 이 길이로 나누어 여러 번 요청해야 합니다. 각 청크의 오디오 파일을 생성 후 이어 붙이는 방식이 일반적입니다.
- 최대 입력 길이: 4,096자 (공백 및 구두점 포함)
- 분할 시 각 청크는 독립적으로 처리됨
- 클라이언트에서 오디오 파일을 연결해야 함
신호 감지 및 워터마크
생성된 모든 오디오 파일에는 인audible(비가청) 워터마크가 적용됩니다. 이는 AI 생성 콘텐츠임을 식별하는 기술적 표시로, 유튜브 등의 플랫폼에서 합성 음성임을 증명하는 데 도움이 됩니다.
- 수동으로 조절 가능한 워터마크 없음
- 모든 출력 파일에 기본적으로 적용
실시간 처리 속도 특징
긴 텍스트의 경우 생성 속도는 약 실시간(1초당 25자)에 가깝습니다. 짧은 문장은 몇 초의 지연이 있을 수 있으며, 서버 부하에 따라 대기열에 배치될 수 있습니다. 스트리밍은 지원하지 않습니다.
- 추정 속도: 분당 60회 요청
- 스트리밍 또는 WebSocket 미지원
- 서버 상태에 따라 지연 발생 가능
에이전시를 위한 확장성
에이전시 워크플로우에 최적화된 구조로, 사이트별 독립 계정을 운영할 수 있습니다. 단일 API 키로 다수 프로젝트를 관리하거나, 프로젝트별 키를 분리하여 리소스를 명확히 추적할 수 있습니다.
API 키는 언제든지 재발급이 가능하며, 기존 키는 새 키 발급 즉시 유효성이 사라집니다. 이는 보안 유지와 키 분산 관리에 적합합니다.
다중 계정 관리 구조
각 에이전시 프로젝트는 독립된 계정으로 구분됩니다. 이를 통해 프로젝트별 사용량과 비용을 명확히 분리하여 관리할 수 있으며, 대량 생성 자동화 시에도 리소스 혼선을 피할 수 있습니다.
- 프로젝트별 독립 계정 운영 가능
- 리소스 사용량 명확한 분리
API 키 발급 및 유효 기간
계정당 활성 키는 하나만 유지됩니다. 필요 시 새로운 키를 발급하면 이전 키는 즉시 정지되므로, 키 노출 시 빠르게 대응할 수 있습니다. 재발급은 언제든지 가능합니다.
- 계정당 활성 키 1개
- 새 키 발급 시 기존 키 즉시 정지
이메일 기반 전문 지원
전화나 라이브 채팅 없이 이메일 기반 지원이 제공됩니다. 기술적 문의나 계정 관련 문제는 이메일을 통해 처리되며, 이는 효율적인 업무 흐름을 지원합니다.
- 이메일 기반 지원
- 전화 및 라이브 채팅 없음

데이터 처리 및 프라이버시
SungVoice는 생성된 오디오 파일이 응답으로 직접 전달되며, 별도의 서버에 저장되지 않습니다. 입력 텍스트는 오디오 생성 목적에만 사용되며, 모델 학습 데이터로 활용되지 않습니다.
입력 텍스트의 학습 사용 여부
사용자가 입력한 텍스트는 음성 합성 프로세스의 일시적 입력값으로만 처리됩니다. 생성이 완료된 후 텍스트는 즉시 제거되며, 향후 AI 모델의 학습 데이터로 재사용되지 않습니다.
생성된 오디오 저장 정책
API 응답을 통해 반환된 오디오 파일은 우리의 서버에 영구 저장되지 않습니다. 클라이언트 단에서 파일을 다운로드하거나 저장하지 않는 한, 생성된 음원은 외부에 보관되지 않습니다.
청구용 메타데이터 보관
과금 및 서비스 관리를 위해 요청 시간, 문자 수, 상태 코드 등의 메타데이터가 보관됩니다. 이 정보는 청구 내역 확인용으로만 사용되며 원본 텍스트나 오디오 콘텐츠와 연결되지 않습니다.
시작하기 위한 준비
PlayMB99에서 YouTube 음성 합성 파이프라인을 시작하려면 먼저 계정 설정이 필요합니다. /get-api-key/ 페이지에서 Google 로그인 또는 이메일 등록을 통해 API 키를 발급받으세요. 키는 대시보드에서 즉시 확인하며, 필요 시 언제든지 재발급할 수 있습니다.
Google 로그인을 통해 7일 유효 기간의 $0.50 무료 체험 크레딧(약 50,000자)을 즉시 사용 가능합니다. 이 크레딧으로 API 호출을 테스트하거나 에이전시 워크플로우의 초기 단계를 검증할 수 있습니다.
Google 로그인으로 API 키 받기
사이트의 /get-api-key/ 페이지에서 'Google 로그인' 버튼을 클릭하여 계정을 생성하세요. 이메일과 비밀번호 방식은 체험 크레딧이 제공되지 않으며, Google 로그인을 통해 즉시 $0.50 크레딧과 API 키가 제공됩니다.
발급된 API 키는 대시보드에서 확인하며, 기존 키는 새 키 발급 시 즉시 무효화됩니다. 이 키를 사용하여 OpenAI 호환 SDK의 base_url을 https://api.playmb99.com/v1로 변경해 통합할 수 있습니다.
무료 체험 크레딧 활용
Google 로그인 시 제공되는 $0.50 크레딧은 7일 동안 유효하며, 약 50,000자의 텍스트 변환에 해당합니다. spaces나 punctuation도 문자 수에 포함되므로, 실제 대본 길이를 고려하여 테스트하세요.
이 크레딧으로 tts-1 또는 tts-1-hd 모델의 성능을 검증하고, 8가지 보이스 프리셋 중 콘텐츠에 적합한 음성을 선택할 수 있습니다. 잔액 소진 전 USDT(TRC-20)로 충전하여 서비스를 계속하세요.
- Google 로그인 시 $0.50 체험 크레딧 자동 제공
- 7일 동안 유효하며 약 50,000자 변환 가능
- 에이전시 워크플로우 초기 테스트에 최적화
첫 번째 API 호출 예시
API 호출은 JSON 형식의 POST 요청을 사용합니다. https://api.playmb99.com/v1/audio/speech 엔드포인트로 model, input, voice, response_format 필드를 전달하세요. 입력 텍스트는 4096자를 초과할 수 없으며, 긴 대본은 분할하여 처리해야 합니다.
예를 들어, "Hello, welcome to my channel" 텍스트를 aria 보이스로 mp3 형식으로 변환하려면 Authorization 헤더에 Bearer 토큰을 설정합니다. 응답으로 오디오 파일이 반환되며, 실패 시 요금이 차감되지 않습니다.
OpenAI Python SDK를 사용할 경우 base_url을 변경하고 동일한 API 형식을 따르므로, 기존 코드 구조를 거의 수정하지 않고 통합할 수 있습니다. 이는 에이전시 워크플로우의 효율성을 높이는 핵심 요소입니다.
- POST https://api.playmb99.com/v1/audio/speech
- JSON body: model, input, voice, response_format
- OpenAI SDK 호환, base_url 변경만으로 통합 가능
자주 묻는 질문 요약
유튜브 크리에이터와 에이전시를 위한 SungVoice API의 핵심 FAQ입니다. 콘텐츠 제작 시 자주 묻는 저작권, 보이스 커스텀, 지원 형식에 대한 명확한 기준을 안내합니다.
이 섹션은 API의 기술적 한계와 정책을 투명하게 공유하여, 안정적인 자동화 워크플로우 구축에 필요한 정보를 제공합니다.
유튜브 저작권 문제
SungVoice가 생성한 모든 오디오 파일에는 합성 음성임을 나타내는 비가청 워터마크가 포함됩니다. 이는 유튜브의 AI 콘텐츠 정책 준수에 도움을 줍니다.
입력 텍스트는 오디오 생성 전용으로 사용되며 학습에 활용되지 않습니다. 생성된 오디오는 응답으로 반환된 후 저장되지 않습니다.
- 모든 파일에는 비가청 워터마크 포함
- 입력 텍스트는 학습용으로 사용되지 않음
- 생성 오디오는 응답 후 즉시 반환, 저장되지 않음
보이스 커스텀 가능 여부
현재 8가지 고정 프리셋(aria, nova, luna 등)만 제공됩니다. 고객 전용 보이스 클로닝이나 사용자 정의 보이스 디자인 기능은 지원하지 않습니다.
LibriTTS-R 데이터셋과 LibriVox 오디오북을 기반으로 한 라이선스된 음성으로 구성되어 있으며, 특정 감정이나 억양을 커스터마이즈할 수 있는 태그는 없습니다.
- 8가지 고정 프리셋만 지원
- 커스텀 보이스 클로닝 및 디자인 불가
- 감정 태그 없음
지원 형식 목록
mp3, wav, opus, flac, pcm 등 5가지 형식을 지원합니다. 유튜브 업로드에는 mp3 또는 wav를 권장합니다.
SSML이나 음소 사전과 같은 고급 텍스트 제어 기능은 제공되지 않습니다. 속도 조절은 0.25에서 4.0까지 가능합니다.
- 지원 형식: mp3, wav, opus, flac, pcm
- SSML 및 음소 사전 미지원
- 속도 범위: 0.25 ~ 4.0
SungVoice 선택 이유
SungVoice는 YouTube 콘텐츠 제작과 에이전시 워크플로우에 특화된 텍스트 음성 변환 API 플랫폼입니다. 대본 자동 음성 합성 파이프라인을 통해 에이전시용 대량 생성 자동화를 지원하며, OpenAI SDK 호환 인터페이스로 빠르게 음성 합성 파이프라인을 구축할 수 있습니다.
USDT(TRC-20) 결제 방식을 통해 빠르고 투명하게 음성 합성 비용을 관리하세요. 100만 문자당 $10의 명확한 과금 구조와 실패 시 환불 정책으로 예산을 효율적으로 운영할 수 있습니다.
에이전시 워크플로우 최적화
대본을 API로 전송해 음성 파일을 즉시 생성할 수 있는 파이프라인을 설계하세요. 4096자 제한 내 텍스트를 분할 처리해 긴 형식의 YouTube 영상 나레이션에도 안정적으로 적용할 수 있습니다.
에이전시 워크플로우에 맞게 API 키를 발급하고, 여러 계정의 사용량을 투명하게 추적하세요.
- 대본 자동 음성 합성 파이프라인 지원
- 에이전시용 대량 생성 자동화 가능
투명한 USDT 결제
문자 수 기반 투명 과금으로 예측 가능한 비용 구조를 유지하세요. 100만 문자당 $10의 고정 요금제와 실패 시 무료 환불 정책으로 불필요한 지출을 줄일 수 있습니다.
USDT(TRC-20)로 최소 $5부터 충전하며, 결제 내역이 명확하게 기록됩니다.
- 문자 수 기반 투명 과금 ($0.01/1000자)
- 실패 시 무료 환불 정책
간단한 API 통합
OpenAI SDK 호환 인터페이스를 통해 기존 개발 환경에 쉽게 통합하세요. JSON body로 모델을 지정하고 음성 파일을 반환받는 방식으로 빠르게 테스트할 수 있습니다.
Google 로그인으로 API 키를 받으며, 첫 API 호출 예시로 즉각적인 검증이 가능합니다.
- OpenAI SDK 호환 인터페이스
- Google 로그인으로 API 키 발급
8개 음성 듣기
아래의 각 샘플은 동일한 문장을 이 API로 생성한 것입니다. 이 정보는 청구 내역 검증 및 기술적 문제 해결에만 사용되며, 실제 텍스트 내용이나 오디오 파일과는 분리되어 관리됩니다.
23개 언어
모든 음성은 이 언어들을 구사합니다.
출처 및 참고 자료
- Wikipedia
- LibriVox public-domain audiobooks
- LibriTTS-R paper (arXiv 2305.18802)
- openai-python on GitHub
- W3C WAI: making audio and video accessible
- LibriTTS-R corpus (OpenSLR 141)
- ISO 639 language codes
- Python documentation
- FFmpeg documentation
- IETF RFC 7845: Ogg Opus
- curl documentation
- OpenAI API reference: create speech
