자주 묻는 질문
유튜브 크리에이터에게 API가 왜 필요한가요?
API를 사용하면 유튜브 콘텐츠 제작에 필요한 음성 파일을 프로그래밍적으로 자동 생성할 수 있습니다. 최대 4096자까지의 텍스트를 보내면 오디오 파일이 반환되므로, 대본 업데이트 시에도 빠르게 음성을 재생성할 수 있습니다. 이를 통해 에이전시 워크플로우의 효율성을 높이고 반복 작업을 효율적으로 처리할 수 있습니다.
API를 사용할 때 가장 중요한 고려 사항은 무엇인가요?
가장 중요한 고려 사항은 문자 수 제한과 속도 제한입니다. 요청당 최대 4096자까지 입력할 수 있으며, 긴 텍스트는 분할하여 처리해야 합니다. 또한 분당 60회 요청 제한이 있으므로, 대량 생성 시 큐 대기 시간을 고려하여 호출 간격을 조절해야 원활한 서비스 이용이 가능합니다.
OpenAI SDK 호환 API의 장점은 무엇인가요?
기존 OpenAI SDK를 그대로 사용할 수 있어 개발 초기 설정이 빠릅니다. base_url만 api.playmb99.com/v1로 변경하면 되므로 별도의 새로운 라이브러리를 배우거나 설치할 필요가 없습니다. 이를 통해 기존 코드베이스를 유지하면서 SungVoice의 TTS 기능을 즉시 통합할 수 있습니다.
API 호출 시 발생할 수 있는 일반적인 오류는 무엇인가요?
주요 오류로는 문자 수 초과, 유효하지 않은 모델 이름, 잘못된 voice ID 등이 있습니다. 또한 분당 60회 제한을 초과하면 요청이 처리되지 않거나 지연될 수 있습니다. API 키가 만료되었거나 잔액이 부족할 때도 오류가 발생하므로, 호출 전 상태 코드를 확인하는 것이 중요합니다.
API 사용 시 데이터 프라이버시는 어떻게 보장되나요?
입력된 텍스트는 오디오 생성에만 사용되며 학습 데이터로 활용되지 않습니다. 생성된 오디오 파일은 응답으로 반환될 뿐 저장되지 않습니다. 요청 시간, 문자 수, 상태와 같은 메타데이터는 청구 목적으로만 유지되므로, 창작자의 원본 콘텐츠가 외부에 공개되거나 재사용될 위험이 낮습니다.
API 키를 여러 개 사용할 수 있는 이유는 무엇인가요?
계정당 활성 키는 하나만 보유합니다. 하지만 필요에 따라 언제든지 새 키를 발급할 수 있습니다. 새 키가 생성되면 이전 키는 즉시 무효화되므로, 워크플로우에 따라 키를 교체하여 사용할 수 있습니다. 이는 보안 유지와 접근 제어에 유용합니다.
API 호출 속도 제한을 초과하면 어떻게 되나요?
초기에는 분당 10회, 이후에는 분당 60회까지 요청할 수 있습니다. 제한을 초과하면 요청이 거부되거나 큐에 대기하게 됩니다. 긴 텍스트의 경우 실시간 속도로 생성되므로, 많은 요청이 있을 경우 처리 지연이 발생할 수 있어 적절한 대기 시간을 두는 것이 좋습니다.
API를 통해 생성된 오디오 파일의 품질은 어떤가요?
8가지 사전 설정된 음성 아티스트 중 하나를 선택하여 오디오를 생성합니다. 각 파일에는 합성 음성을 나타내는 무음수 마크가 포함되어 있습니다. mp3, wav, opus 등 다양한 형식을 지원하며, 속도 조절 기능으로 음성의 빠르기나 느림을 조절할 수 있습니다.
API 사용 시 예상되는 비용은 어떻게 계산되나요?
100만 문자당 10달러의 요금이 부과됩니다. 공백과 구두점도 문자 수에 포함되므로 실제 입력 길이를 정확히 계산해야 합니다. 실패한 요청에 대해서는 요금이 청구되지 않으며, 잔액은 만료되지 않습니다. USDT(TRC-20)로 최소 5달러 이상 충전하여 사용할 수 있습니다.
API를 프로그래밍 없이 사용할 수 있나요?
주요 사용 방식은 API 호출이므로 프로그래밍이 필요합니다. 별도의 모바일 SDK나 브라우저 확장 프로그램, 워드프레스 플러그인은 제공되지 않습니다. curl 예제나 OpenAI SDK를 사용하여 스크립트로 요청을 보내야 하므로, 기본적인 프로그래밍 지식이 필요합니다. GUI 기반의 별도 편집 도구는 제공되지 않습니다.
API 지원 언어는 총 몇 개이며, 한국어는 포함되나요?
총 23개 언어를 지원합니다. 한국어는 목록에 포함되어 있습니다. 지원 언어는 아랍어, 중국어, 덴마크어, 네덜란드어, 영어, 핀란드어, 프랑스어, 독일어, 그리스어, 히브리어, 힌디어, 이탈리아어, 일본어, 한국어, 말레이어, 노르웨이어, 폴란드어, 포르투갈어, 러시아어, 스페인어, 스와힐리어, 스웨덴어, 터키어입니다.
API 키 발급 후 첫 호출까지 걸리는 시간은?
API 키 발급 후 즉시 호출이 가능합니다. 키는 발급과 동시에 활성화되며, 추가적인 대기 시간이 필요하지 않습니다. 다만, 초기에는 분당 10회의 제한이 적용되므로, 첫 호출 전 설정 확인이 필요합니다. 요청 처리는 순차적으로 이루어지므로 부하에 따라 대기 시간이 발생할 수 있습니다.
API 호출 실패 시 환불은 어떻게 받나요?
합성 실패 시 청구된 금액이 전액 환불됩니다. 별도의 신청 절차나 기간 제한 없이 자동으로 처리됩니다. 실패한 요청은 요금이 부과되지 않으므로, 실패 원인을 확인하고 재시도하면 됩니다. 이는 안정적인 서비스 이용을 보장하는 중요한 기능입니다.
API를 유튜브 영상 제작에 활용하는 사례는 무엇인가요?
유튜브 영상 제작에는 대본을 텍스트로 입력하여 음성 파일로 변환하는 워크플로우가 적합합니다. 에이전시에서는 여러 클라이언트의 대본을 자동으로 처리하여 음성 파일을 생성할 수 있습니다. 8가지 음성 중 하나를 선택하여 일관된 톤을 유지하며, 속도 조절로 다양한 연출이 가능합니다.
API 선택을 위한 핵심 기준
유튜브 음성 자동화 파이프라인을 구축할 때 OpenAI SDK 호환성은 개발 효율성을 결정합니다. PlayMB99은 POST /v1/audio/speech 엔드포인트를 통해 동일한 JSON 구조를 제공하므로, 기존 OpenAI SDK를 base_url만 변경하여 즉시 사용할 수 있습니다. 이는 에이전시 워크플로우에서 추가 라우팅 레이어 없이도 빠르게 통합할 수 있게 합니다.
가격 투명성은 예산 계획의 핵심입니다. PlayMB99은 100만 문자당 $10의 단순 과금 모델을 적용하며, 실패 요청은 무료입니다. 공간과 구두점도 문자 수에 포함되므로 정확한 분할 로직이 필요하며, USDT(TRC-20) 기반 충전으로 추가 수수료 없이 투명하게 비용을 관리할 수 있습니다.
OpenAI SDK 호환성 중요성
PlayMB99의 API는 OpenAI 스타일의 speech 엔드포인트를 완벽히 따릅니다. base_url을 https://api.playmb99.com/v1로 변경하고 Bearer 토큰 인증만 설정하면 됩니다. 이는 Python, Node.js 등 주요 언어의 공식 SDK를 그대로 활용하여 대본 생성부터 오디오 파일 다운로드까지 단일 라이브러리로 처리할 수 있게 합니다.
이 호환성은 에이전시 워크플로우에서 기존 인프라와의 연동을 간소화합니다. 별도의 커스텀 클라이언트 개발 없이도 rate limit 처리나 재시도 로직을 기존 패턴으로 적용할 수 있어, 유지보수 비용을 절감하고 배포 속도를 높일 수 있습니다.
가격 투명성 비교
과금은 생성된 문자 수에 따라 발생하며, 실패 시에는 요금이 청구되지 않습니다. 이는 대본 전처리 과정에서 발생할 수 있는 오류 비용을 최소화합니다. 100만 자당 $10(10만 자당 $1)의 명확한 비용 구조로 유튜브 시리즈의 예산을 정확히 예측할 수 있습니다.
USDT(TRC-20) 결제는 전통적인 신용카드나 PayPal보다 빠른 충전 속도를 제공합니다. 최소 $5부터 충전 가능하며, 충전금은 즉시 반영되어 대기 시간 없이 API 호출이 가능합니다. 추가 구독료나 숨겨진 요금이 없어 실제 사용량만 과금됩니다.
언어 및 보이스 지원 범위
23개 언어와 8가지 전문 보이스 프리셋을 지원합니다. 한국어, 영어, 일본어 등 주요 언어를 비롯해 아랍어, 힌디어 등 다양하게 커버합니다. 각 보이스는 특정 장르(예: 뉴스, 스토리텔링)에 최적화되어 있어 콘텐츠 톤에 맞는 음성을 쉽게 선택할 수 있습니다.
모든 보이스는 모든 언어를 지원하므로, 특정 언어 전용 모델을 찾지 않아도 됩니다. 언어 코드를 명시하지 않으면 스크립트에 따라 자동 감지되지만, 정확한 결과를 위해 명시적 언어 설정을 권장합니다. 이는 다국어 유튜브 채널 운영 시 일관된 음질과 톤을 유지하는 데 도움이 됩니다.
PlayMB99의 기술적 우위
PlayMB99은 유튜브 제작 워크플로우에 최적화된 8가지 전문 보이스 프리셋을 제공합니다. aria, nova, luna, sage 등 여성 보이스와 felix, milo, atlas, orion 등 남성 보이스를 통해 다양한 콘텐츠 톤앤매너를 구현할 수 있습니다.
이들 보이스는 LibriTTS-R 및 LibriVox의 라이선스된 음원을 기반으로 하며, 모든 생성 오디오 파일에는 무음의 워터마크가 적용되어 합성 음성임을 식별할 수 있습니다.
8가지 전문 보이스 프리셋
aria는 따뜻하고 명확한 내레이터 톤으로, nova는 밝고 경쾌한 스타일을 지원합니다. luna와 sage는 각각 부드러운 스토리텔링과 차분한 교육용 콘텐츠에 적합합니다.
남성 보이스인 felix는 에너지 넘치는 프로모션에, milo는 친근한 대화체 형식에 적합합니다. atlas는 중립적인 뉴스 스타일, orion은 심층적인 다큐멘터리 형식에 적합합니다.
- aria: 따뜻하고 명확한 내레이터 톤
- nova: 밝고 경쾌한 스타일
- luna: 부드러운 스토리텔링 톤
- sage: 차분한 교육형 보이스
- felix: 에너지 넘치는 프로모션 보이스
- milo: 친근한 대화체 보이스
- atlas: 중립적인 뉴스 스타일
- orion: 심층 다큐멘터리 형식 보이스
23개 언어 지원 범위
아랍어, 중국어, 덴마크어, 네덜란드어, 영어, 핀란드어, 프랑스어, 독일어, 그리스어, 히브리어, 힌디어, 이탈리아어, 일본어, 한국어, 말레이어, 노르웨이어, 폴란드어, 포르투갈어, 러시아어, 스페인어, 스와힐리어, 스웨덴어, 터키어를 지원합니다.
모든 보이스는 모든 지원 언어를 구사할 수 있습니다. 언어가 지정되지 않으면 스크립트 기반으로 감지되지만, 비영어권 라틴 문자 텍스트의 경우 명시적 language 파라미터 설정이 권장됩니다.
- 아랍어, 중국어, 덴마크어, 네덜란드어
- 영어, 핀란드어, 프랑스어, 독일어
- 그리스어, 히브리어, 힌디어, 이탈리아어
- 일본어, 한국어, 말레이어, 노르웨이어
- 폴란드어, 포르투갈어, 러시아어, 스페인어
- 스와힐리어, 스웨덴어, 터키어
USDT 기반 즉시 결제
USDT(TRC-20)를 통한 최소 $5 충전으로 분당 60회 요청까지 처리할 수 있는 유연한 사용량을 확보합니다. 충전은 트론 네트워크를 통해 수분 내에 자동으로 처리됩니다.
월 구독이나 추가 요금 없이, 생성된 문자 수에 따라 투명하게 과금됩니다. 실패한 요청은 요금이 환원되며, 잔액은 만료되지 않아 장기적인 워크플로우에 적합합니다.
워크플로우 자동화 전략
유튜브 콘텐츠 제작 시 긴 대본은 4,096자 제한을 고려해 분할해야 합니다. 각 청크를 독립적으로 처리한 후 오디오 파일을 연결하여 완성된 음성을 생성하세요.
요청은 순서대로 처리되므로, 대용량 데이터의 경우 큐 대기 시간을 고려해 스케줄링해야 합니다. 짧은 문장은 수 초, 긴 텍스트는 실시간 속도로 생성됩니다.
대본prep 및 분할 처리
대본을 4,096자 단위로 나누어 API에 전송하세요. 공백과 특수문자도 문자 수에 포함되므로 정확히 계산해야 합니다.
API 호출 스케줄링
분할된 청크를 순차적으로 호출하여 생성된 오디오 파일을 기다립니다. 병렬 처리 시 속도 제한(분당 60회)을 초과하지 않도록 주의하세요.
오디오 파일 통합
생성된 각 오디오 파일을 순서대로 결합하여 최종 유튜브 영상에 사용할 음성을 완성합니다. MP3, WAV 등 원하는 형식으로 저장하세요.
에이전시 맞춤형 설정
에이전시는 여러 프로젝트에 독립적인 API 키를 발급받아 리소스를 분리할 수 있습니다. 각 키는 60회의 분당 요청 제한을 가지며, 새로운 키 발급 시 기존 키가 즉시 정지되므로 프로젝트 전환 시 명확한 제어가 가능합니다.
이 구조를 통해 고객별 사용량을 격리하고, 과금 오류나 한도 초과 시 전체 서비스 중단 없이 개별 계정만 조정할 수 있어 효율적인 워크플로우 관리를 지원합니다.
다중 API 키 관리
에이전시는 프로젝트별 또는 고객별 독립 API 키를 발급받아 관리할 수 있습니다. 각 키는 독립적인 사용량과 한도를 가지며, 새 키 발급 시 이전 키는 즉시 정지됩니다. 이를 통해 프로젝트 간 리소스 충돌을 방지하고 명확한 비용 배분이 가능합니다.
키 생성 및 폐기 과정이 즉시 반영되므로, 임시 테스트용 키나 특정 캠페인용 키를 유연하게 운용할 수 있습니다. 한계는 60 RPM으로, 대용량 병렬 처리 시 키 분산이 필요합니다.
- 프로젝트별 독립 키 발급 가능
- 새 키 발급 시 이전 키 즉시 정지
- 키별 개별 사용량 추적 가능
사용량 모니터링 도구
계정 페이지에서는 남은 잔액, 생성된 문자 수, API 호출 이력을 확인할 수 있습니다. 이는 에이전시가 여러 클라이언트의 TTS 비용을 정확히 산정하고 보고하는 데 필수적입니다.
메타데이터는 청구 목적으로만 보관되며, 생성된 오디오 파일은 저장되지 않습니다. 따라서 과거 데이터 재조회 시 API 호출 기록을 기반으로 내역을 검증할 수 있습니다.
- 실시간 잔액 및 문자 수 확인
- API 호출 이력 조회
- 청구 메타데이터 보관
오류 처리 자동화
TTS API는 실패 시 과금을 환불하므로, 자동화 스크립트에서 실패 응답 확인 후 재시도 로직을 구현할 수 있습니다. 이는 에이전시 워크플로우의 신뢰성을 높이는 핵심 요소입니다.
속도 제한(60 RPM)을 초과할 경우 큐 처리가 발생하므로, 스크립트에서 HTTP 상태 코드를 확인하고 적절한 대기 시간을 둔 후 재시도하는 로직을 적용해야 합니다.
- 실패 시 과금 환불 보장
- HTTP 상태 코드 기반 재시도 로직
- RPM 초과 시 큐 처리 이해
비용 최적화 전략
유튜브 콘텐츠 제작에서 TTS API 비용 효율성을 극대화하려면 문자 단위 과금 구조를 정확히 이해해야 합니다. 100만 자당 10달러로, 공백과 문장 부호도 포함되므로 대본 길이 최적화가 중요합니다. 이는 에이전시 워크플로우에서 반복 생성 비용 예측을 가능하게 합니다.
문자 수 기반 과금 활용
1,000자당 0.01달러의 명확한 단가로, 대본 분할 전략이 핵심입니다. 4,096자 제한을 초과하는 긴 스크립트는 여러 요청으로 나누어 처리해야 하며, 각 청크의 문자 수를 정확히 계산하여 과금을 최소화하세요. 이는 유튜브 긴 형식 콘텐츠 제작에 필수적입니다.
- 공백 및 문장부호 포함 문자 수 정확히 계산
- 4,096자 제한 내 대본 분할 전략 수립
- 반복 사용 시 비용 예측 정확도 향상
실패 시 환불 정책
합성 실패 시 청구 금액이 전액 반환되므로, 불안정한 네트워크 환경에서도 안전합니다. 에이전시 워크플로우에서 자동화 스크립트 실패 시 추가 비용 부담이 없음을 의미합니다. 이는 안정적인 서비스 제공을 위한 핵심 안전장치로 작용합니다.
- 합성 실패 시 전액 환불 보장
- 자동화 스크립트 실패 시 추가 비용 없음
- 안정적인 워크플로우 유지에 필수적
USDT 충전 주기
USDT(TRC-20) 기반 충전은 최소 5달러부터 가능하며, 이체 후 수분 내로 자동 크레딧이 적용됩니다. 월 구독제나 최소 사용량이 없으므로, 프로젝트 단위로 유연하게 자금을 충전할 수 있습니다. 이는 소규모 에이전시나 프리랜서에게 최적화된 결제 방식입니다.
- 최소 5달러부터 유연한 충전 가능
- 이체 후 수분 내 자동 크레딧 적용
- 월 구독제 없이 프로젝트 단위로 관리
데이터 처리 및 보안
PlayMB99의 TTS API는 입력된 텍스트를 오디오 생성에만 사용하며 학습용으로 활용하지 않습니다. 생성된 오디오 파일은 응답으로 즉시 반환되며 서버에 저장되지 않습니다.
청구용 메타데이터(시간, 문자 수, 상태)만 유지하여 과금 내역을 투명하게 관리합니다. 모든 데이터 처리는 단순하고 명확한 원칙에 기반합니다.
입력 데이터 사용 정책
고객이 제공한 텍스트는 오직 음성 합성 목적에만 사용됩니다. 생성 과정이 완료되면 텍스트 데이터는 별도로 보관하거나 학습 데이터셋에 추가하지 않습니다.
- 입력 텍스트는 생성 전용으로 사용됨
- 학습 또는 재사용 목적의 저장 없음
청구 메타데이터 보관
요청 시간, 문자 수, 상태 코드는 과금 정확도를 위해 기록됩니다. 이 데이터는 오직 계정 사용량 확인과 청구 검증에 사용됩니다.
API 키 보안
계정당 활성 키는 하나만 유지됩니다. 새 키를 발급하면 이전 키는 즉시 무효화되므로 키 분실 시 즉각적인 접근 차단이 가능합니다.
보안 상의 이유로 장기적인 키 유효성 검증보다는 필요 시 재생성을 권장합니다. 이는 불필요한 키 유통을 방지합니다.
성능 및 확장성
API는 분당 60회 요청을 처리합니다. 초기 10회는 분당 10회로 제한되며, 충전 후 즉시 제한이 해제됩니다. 이는 안정적인 서비스 제공을 위한 기본 설정입니다.
속도 제한 이해
초기 계정은 분당 10회의 요청만 허용됩니다. 첫 충전 후 제한이 분당 60회로 확대됩니다. 이는 과도한 사용으로 인한 서버 부하를 방지하기 위한 조치입니다.
큐 처리 메커니즘
요청은 순서대로 처리됩니다. 동시 요청이 많으면 대기열에 배치되어 지연될 수 있습니다. 짧은 문장은 몇 초, 긴 텍스트는 실시간 속도로 생성됩니다.
대규모 요청 처리
4096자 초과 텍스트는 자동으로 분할되어 생성됩니다. 생성된 오디오 파일은 최종적으로 결합됩니다. 이를 통해 긴 대본도 오류 없이 일관된 품질로 변환됩니다.

지원 및 유지보수
PlayMB99은 전화나 실시간 채팅 지원 없이 이메일 기반의 효율적인 고객 지원을 제공합니다. 기술적 문의나 계정 관련 문제는 이메일로 문의하면 지원팀이 답변합니다.
이메일 지원 채널
모든 문의는 이메일로 처리됩니다. 전화 번호나 라이브 채팅 창이 별도로 제공되지 않으므로, 자세한 설명과 관련 로그를 첨부하여 이메일로 문의해 주세요.
문서 및 FAQ 활용
/docs/ 페이지에서 API 호출 방법, 파라미터 설명, 예시 코드를 확인할 수 있습니다. 자주 묻는 질문(FAQ)을 통해 일반적인 오류 코드나 속도 제한 관련 정보를 사전에 확인하세요.
문서를 먼저 참고하면 지원 요청 시 필요한 정보를 더 명확히 전달할 수 있어 처리 속도가 빨라집니다.
- API 엔드포인트 및 요청 형식
- 에러 코드 및 해결 방법
- 사용 예시 코드 (cURL, Python 등)
API 업데이트 확인
변경 사항은 공식 문서나 계정에 공지됩니다. 변경 사항을 사전에 확인하여 워크플로우의 호환성을 유지하세요.
업데이트 내용에는 API 엔드포인트 변경, 새로운 보이스 추가, 또는 가격 정책 변경 등이 포함될 수 있습니다.
유튜브 저작권 고려사항
유튜브 콘텐츠 제작 시 생성된 음성의 라이선스 상태는 중요한 고려 사항입니다. SungVoice의 보이스는 LibriTTS-R 데이터셋(CC BY 4.0) 및 LibriVox의 퍼블릭 도메인 오디오북 읽기를 기반으로 합니다.
이 데이터셋의 특성에 따라 생성된 오디오 파일은 상업적 사용이 일반적으로 허용되지만, 구체적인 사용 권한은 최종 라이선스 확인이 필요합니다. 또한 모든 생성 파일에는 합성 음성임을 나타내는 무음의 워터마크가 포함되어 있어 원본 음성과 구분됩니다.
라이선스된 음성 데이터
SungVoice의 8개 보이스 프리셋은 모두 라이선스된 음성 데이터를 기반으로 생성됩니다. LibriTTS-R(CC BY 4.0) 데이터셋과 LibriVox의 퍼블릭 도메인 오디오북 읽기 소스를 사용하여 음성을 구성합니다.
이러한 기반은 합성 음성임을 명시하는 무음의 워터마크를 파일에 포함시킵니다. 워터마크는 청각적으로 구분하기 어렵지만, 생성된 오디오가 AI 합성임을 확인하는 수단으로 기능합니다.
- LibriTTS-R 데이터셋(CC BY 4.0) 기반
- LibriVox 퍼블릭 도메인 오디오북 읽기 소스 사용
- 모든 파일에 무음의 합성 워터마크 포함
상업적 사용 허용
수집된 음성 데이터는 상업적用途를 고려하여 라이선스되었습니다. 따라서 유튜브와 같은 플랫폼에서 생성된 음성을 사용하여 수익성 있는 콘텐츠를 제작하는 것이 가능합니다.
대본prep 및 API 호출을 통해 생성된 오디오 파일은 별도의 추가 라이선스 없이 유튜브 콘텐츠에 통합할 수 있습니다. 이는 에이전시 워크플로우에서 효율적인 콘텐츠 생산을 지원합니다.
- 유튜브 콘텐츠 제작에 적합한 라이선스 구조
- 상업적 사용 가능
- 별도 추가 라이선스 불필요
독점성 확인
SungVoice는 사용자 고유의 음성 클로닝 기능을 제공하지 않습니다. 따라서 특정 개인의 목소리를 복제하여 독점적으로 사용하는 것은 불가능합니다.
모든 보이스는 8가지 프리셋 중 하나를 선택하여 생성됩니다. 이는 동일한 보이스를 사용하는 다른 사용자와의 차별성을 고려해야 함을 의미합니다.
워터마크는 합성 음성을 식별하는 역할을 하지만, 특정 사용자의 독점성을 보장하지는 않습니다. 콘텐츠의 독점성은 대본 및 편집 전략에 좌우됩니다.
- 사용자 고유의 음성 클로닝 기능 없음
- 8가지 프리셋 기반 보이스 사용
- 워터마크는 합성 음성 식별용
시작하기 위한 단계
PlayMB99의 TTS API를 유튜브 콘텐츠에 통합하기 위한 첫 단계입니다. 계정 생성부터 실제 오디오 생성까지의 과정을 체계적으로 안내하여, 복잡한 설정 없이 빠르게 파이프라인을 구축할 수 있습니다.
간단한 설정으로 시작해, 이후 워크플로우 자동화 전략과 연결할 수 있는 안정적인 기반을 마련하세요.
계정 생성 및 API 키 발급
playmb99.com/get-api-key/ 페이지에서 Google 또는 이메일/비밀번호로 계정을 생성하세요. 생성된 페이지에서 API 키를 확인하고, 무료 체험 크레딧($0.50) 또는 USDT 충전을 통해 시작합니다.
API 키는 계정당 하나만 활성되며, 필요 시 새 키를 발행하면 이전 키는 즉시 정지됩니다. 키는 Authorization 헤더에 Bearer 형태로 포함해야 합니다.
- Google 또는 이메일/비밀번호로 계정 생성
- API 키 확인 및 복사
- USDT(TRC-20) 충전 또는 무료 체험 크레딧 활성화
첫 API 호출 테스트
POST https://api.playmb99.com/v1/audio/speech 엔드포인트에 JSON body를 전송합니다. model("tts-1" 또는 "tts-1-hd"), input(4096자 이하), voice, response_format(mp3/wav 등)을 설정하세요.
성공 시 오디오 파일이 반환되며, 실패 시 과금이 발생하지 않습니다. 60분당 60회의 속도 제한을 준수하며, 실패 요청은 전액 환불됩니다.
- 엔드포인트: POST https://api.playmb99.com/v1/audio/speech
- 필수 필드: model, input, voice, response_format
- 성공 시 오디오 반환, 실패 시 무료
워크플로우 구축
긴 대본은 4096자 단위로 분할하여 여러 API 호출을 수행하고, 생성된 오디오 파일을 병합하세요. 이는 1회 요청 제한을 우회하고 효율적인 처리를 가능하게 합니다.
OpenAI 호환 SDK를 사용하거나 HTTP 요청을 통해 자동화 스크립트를 구축하세요. 생성된 오디오는 유튜브 업로드 전 최종 검수 후 활용합니다.
- 4096자 단위 대본 분할
- API 응답 오디오 파일 병합
- OpenAI SDK 또는 HTTP 자동화 스크립트 구축
자주 묻는 질문 및 문제 해결
API 호출 중 429 오류가 발생하면 속도 제한(분당 60회)을 초과했음을 의미합니다. 첫 충전 전에는 분당 10회로 제한되므로, 요청 간 간격을 두거나 버스트 로딩 전략을 사용하세요. 400 오류는 일반적으로 잘못된 모델 이름이나 4096자를 초과한 입력 텍스트에서 발생합니다.
API 호출 오류 처리
429 오류는 분당 60회 한도를 초과했을 때 발생합니다. 초기에는 분당 10회로 제한되므로 요청 간 대기 시간을 두세요. 400 오류는 입력 텍스트가 4096자를 초과했거나 필수 필드가 누락되었을 때 발생합니다. 입력 텍스트는 자동으로 분할되지 않으므로, 클라이언트 측에서 4096자 단위로 나누어 여러 번 호출해야 합니다.
- 429 오류: 분당 60회 제한 (초기 분당 10회)
- 400 오류: 입력 텍스트 초과 또는 필드 누락
- 500 오류: 서버 내부 오류 (잠시 후 재시도)
속도 제한 초과 시 대응
분당 60회 요청 한도를 초과하면 429 Too Many Requests 오류가 반환됩니다. 초기 계정에는 분당 10회 제한이 적용되므로, 배치 처리 시 간격을 두어야 합니다. 대용량 텍스트 처리 시 각 청크 간 최소 1초 이상 대기하여 제한을 준수하세요.
- 분당 60회 일반 제한
- 초기 계정 분당 10회 제한
- 대용량 텍스트 처리 시 간격 두기
결제 문제 해결
USDT(TRC-20)로 충전했으나 잔고가 반영되지 않으면, 트랜잭션 해시(_TXID_)를 확인하세요. 전송이 확인되면 자동으로 잔고가 충전됩니다. 5달러 미만의 소액 충전은 최소 한도 미달로 처리될 수 있으므로, 최소 5달러 이상을 충전하세요. Google 로그인 계정은 $0.50 체험금을 제공하지만, 이메일/비밀번호 계정에는 체험금이 없습니다.
결론 및 다음 단계
TTS API 통합은 유튜브 콘텐츠 제작의 속도와 일관성을 높이는 효율적인 방법입니다. OpenAI SDK 호환성과 투명한 USDT 결제를 통해 복잡한 워크플로우를 간소화할 수 있습니다.
이제 API 키를 발급하고 첫 음성을 생성해 보세요. 데이터 처리 정책과 성능 한계를 이해하면 더 안정적인 파이프라인을 구축할 수 있습니다.
API 통합의 이점 요약
API를 활용하면 대본 분할, 음성 합성, 파일 통합 과정이 자동화됩니다. 이는 에이전시 워크플로우에서 시간 절약과 품질 일관성을 보장합니다.
투명한 과금과 빠른 USDT 충전은 비용 예측을 용이하게 합니다. 실패 시 환불 정책 또한 리스크를 줄여줍니다.
- 8개 보이스와 23개 언어 지원
- OpenAI SDK 호환성
- USDT 기반 즉시 결제
워크플로우 개선 제안
대본을 4096자 단위로 미리 분할하여 API 호출을 준비하세요. 이는 큐 대기 시간을 최소화하는 핵심 단계입니다.
오류 처리 로직을 추가하여 실패한 요청을 자동으로 재시도하도록 구성하세요.
- 대본 전처리 자동화
- 오류 재시도 로직 구현
지속적인 학습 자료
공식 문서와 FAQ를 정기적으로 확인하여 API 업데이트 사항을 파악하세요.
커뮤니티 포럼이나 관련 기술 블로그를 통해 최적 사례를 지속적으로 학습하세요.
- 공식 문서 링크
- API 업데이트 로그
8개 음성 듣기
아래의 각 샘플은 동일한 문장을 이 API로 생성한 것입니다. 이 정보는 청구 내역 검증 및 기술적 문제 해결에만 사용되며, 실제 텍스트 내용이나 오디오 파일과는 분리되어 관리됩니다.
23개 언어
모든 음성은 이 언어들을 구사합니다.
