IoT 기기용 음성 합성 API

작성자 HomelyVoice 편집팀 · 업데이트됨 2026-11-19

이 페이지에서는 스마트 홈 및 IoT 스타트업을 위한 HomelyVoice TTS API의 핵심 기능과 기술 스펙을 안내합니다. OpenAI SDK 호환 엔드포인트를 통해 다양한 디바이스에 음성 기능을 쉽게 통합할 수 있는 방법을 확인하세요.

8가지 preset 음성, 23개 언어 지원, 실시간에 가까운 생성 속도 등 제품 사양과 요금제, API 사용 가이드를 제공합니다. 개발자가 직접 API 키를 발급하고 통합 프로세스를 빠르게 설정할 수 있도록 구체적인 정보를 정리했습니다.

IoT 기기용 음성 합성 API

자주 묻는 질문

TTS API는 무엇인가요?

HomelyVoice는 스마트 홈 및 IoT 기기에 음성 기능을 통합하기 위한 클라우드 기반 텍스트 음성 변환 API입니다. POST 요청으로 텍스트를 보내면 MP3, WAV 등 오디오 파일이 반환됩니다. 4096자까지의 텍스트를 처리하며, 요청당 약 25자의 텍스트를 실시간에 가까운 속도로 변환합니다. IoT 게이트웨이나 스마트 스피커에 쉽게 통합할 수 있는 단순한 REST API 형태입니다.

네이버 음성 변환 서비스와 어떻게 다른가요?

네이버 등 타사는 자체 SDK나 복잡한 파이프라인을 제공하지만, HomelyVoice는 OpenAI SDK와 호환되는 단순 REST API를 제공합니다. base_url만 변경하면 바로 사용 가능합니다. 월 구독제나 seats가 없으며, TRC-20 USDT로만 결제합니다. SLA나 인증이 없으며, 이메일 지원만 제공합니다. 대용량 텍스트 처리와 명확한 과금 구조가 특징입니다.

지원하는 언어는 무엇인가요?

영어, 한국어, 일본어, 중국어, 스페인어, 프랑스어, 독일어, 이탈리아어, 포르투갈어, 러시아어, 아랍어, 힌디어, 터키어, 폴란드어, 스웨덴어, 노르웨이어, 덴마크어, 핀란드어, 그리스어, 히브리어, 말레이어, 스와힐리어 등 23개 언어를 지원합니다. 모든 보이스는 모든 언어를 구사합니다. 언어가 지정되지 않으면 스크립트에 따라 추측되나, 비영어권 라틴 문자 텍스트는 언어 코드를 명시해야 합니다.

성우(보이스)는 어떻게 선택하나요?

GET /v1/voices 엔드포인트를 통해 이용 가능한 8가지 보이스 프리셋을 확인하세요. Aria, Nova, Luna, Sage(여성)와 Felix, Milo, Atlas, Orion(남성) 중 선택합니다. 각 보이스는 LibriTTS-R 및 LibriVox 데이터 기반으로 제작되었으며, 생성된 오디오에는 합성 음성 표시용 워터마크가 포함됩니다. API 요청 시 voice 파라미터에 보이스 이름을 지정하면 됩니다.

오디오 파일 포맷은 무엇이 있나요?

mp3, wav, opus, flac, pcm 포맷을 지원합니다. response_format 파라미터를 통해 원하는 포맷을 지정할 수 있습니다. IoT 기기나 스마트 스피커의 용량 및 호환성 요구사항에 따라 가장 적합한 포맷을 선택하여 오디오 파일을 생성할 수 있습니다. 각 포맷은 동일한 엔진에서 생성되며, 모델(tts-1 또는 tts-1-hd)에 따라 품질이 결정됩니다.

요청 제한(Rate Limit)은 어떻게 되나요?

키당 분당 60회 요청이 가능합니다. 첫 충전 전에는 분당 10회로 제한됩니다. 텍스트가 4096자를 초과할 경우 여러 요청으로 분할되어 처리되므로, 실제 사용 시 이 한도를 고려해야 합니다. 부하가 걸리면 요청이 큐에 대기될 수 있으며, 이는 처리 지연으로 이어질 수 있습니다. 정확한 사용량 모니터링은 대시보드에서 확인하세요.

오류 발생 시 과금은 어떻게 되나요?

합성 실패 시 과금은 발생하지 않습니다. 오류가 발생하면 요금이 전액 환불됩니다. 성공적으로 오디오가 생성된 경우에만 문자 수에 따라 요금이 부과됩니다. 이는 API 호출 실패 시 추가 비용 부담을 줄여주는 정책으로, 안정적인 IoT 서비스 연동에 유리합니다. 실패 상태 코드를 확인하여 재시도 로직을 구현할 수 있습니다.

데이터는 어떻게 처리되나요?

입력 텍스트는 오디오 생성에만 사용되며 학습 데이터로 활용되지 않습니다. 생성된 오디오는 응답으로 반환되며 서버에 저장되지 않습니다. 청구 및 과금 목적으로 요청 메타데이터(시간, 문자 수, 상태)만 보관됩니다. 따라서 민감한 음성 데이터를 생성할 때 데이터 영구 저장에 대한 우려가 없습니다. 프라이버시 보호가 중요한 IoT 애플리케이션에 적합합니다.

스트리밍을 지원하나요?

스트리밍, WebSocket, 실시간 부분 오디오는 지원하지 않습니다. 텍스트를 전송하면 전체 오디오 파일이 생성되어 반환됩니다. 대용량 텍스트의 경우 분할 후 파일로 결합됩니다. 실시간성이 중요한 IoT 시나리오에서는 전체 파일 다운로드를 전제로 한 설계가 필요합니다. 스트리밍이 필요하지 않은 배치 처리나 단순 재생 환경에 적합합니다.

SSML을 지원하나요?

SSML은 지원하지 않습니다. 텍스트만 입력하며, 속도(speed)와 언어(language) 파라미터로 제어할 수 있습니다. 발음 사전이나 감정 태그, 음소 레벨 제어 기능이 없습니다. 단순하고 명확한 텍스트 지시사항이 필요한 IoT 기기나 스피커용 음성 생성에 최적화되었습니다. 복잡한 음성 제어보다는 빠른 통합을 원할 때 적합합니다.

커스텀 음성 클로닝이 가능한가요?

커스텀 음성 클로닝은 제공되지 않습니다. 8가지 사전 설정된 보이스 중 하나를 선택하여 사용합니다. 사용자의 음성을 업로드하거나 맞춤형 보이스를 설계할 수 없습니다. 고정된 보이스 품질과 일관된 음성을 유지해야 하는 IoT 제품에 적합합니다.

API 키는 어떻게 발급받나요?

https://tb7.info/get-api-key/ 페이지에서 Google 또는 이메일/비밀번호로 가입하세요. 가입 후 대시보드에서 API 키를 발급받고 확인할 수 있습니다. 키는 계정당 하나만 활성화되며, 새 키를 발급하면 이전 키는 즉시 정지됩니다. 키는 Authorization 헤더에 Bearer 토큰 형태로 전달해야 합니다.

결제 방법은 무엇인가요?

USDT(TRC-20)로만 결제합니다. 최소 $5 이상 충전 시 자동으로 크레딧이 추가됩니다. 신용카드, PayPal, 구독제, 세금 계산서는 제공되지 않습니다. 잔액은 만료되지 않으며, 월별 요금제가 없습니다. $10/100만 문자의 정산 방식으로, 실패 시 과금되지 않습니다. TRON 네트워크 송금 후 수분 내 크레딧이 반영됩니다.

무료 체험은 어떻게 하나요?

Google로 가입 시 $0.50(약 5만 문자)의 무료 체험 크레딧이 7일 동안 제공됩니다. 이메일/비밀번호 가입 시 체험 크레딧이 없습니다. 체험 기간 내 과금되지 않으며, 기간 만료 시 크레딧이 소멸됩니다. API 키 발급 후 대시보드에서 잔액과 남은 문자 수를 확인할 수 있습니다. 초기 테스트에 적합합니다.

첫 번째 요청

curl

curl https://api.tb7.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

스마트 홈 및 IoT 기기를 위한 음성 합성 API

에 대한 소리 파동 일러스트레이션: 스마트 홈 및 IoT 기기를 위한 음성 합성 API

HomelyVoice는 스마트 홈 및 IoT 스타트업을 위한 클라우드 기반 TTS API입니다. OpenAI SDK와 호환되는 엔드포인트를 제공하여, 기존 개발 환경에서 base_url 변경만으로 간편하게 음성 합성 기능을 통합할 수 있습니다.

8가지 preset 음성과 23개 언어를 지원하며, 대용량 텍스트도 실시간에 가까운 속도(약 25자/초)로 처리됩니다. 스마트 스피커, 리모컨, 게이트웨이 등 다양한 디바이스에 음성 기능을 안정적으로 적용할 수 있습니다.

OpenAI SDK 호환 API 엔드포인트

OpenAI SDK 호환 API 엔드포인트

API는 POST /v1/audio/speech 엔드포인트를 사용하며, JSON 형식의 요청 body를 받습니다. 기존 OpenAI SDK를 그대로 활용하되 base_url을 https://api.tb7.info/v1로 설정하기만 하면 됩니다. 별도의 전용 SDK 설치 없이 HTTP 클라이언트나 표준 라이브러리로도 연동이 가능합니다.

  • POST /v1/audio/speech 엔드포인트 지원
  • OpenAI SDK 호환 (base_url 변경 가능)
  • JSON 기반 요청 형식

8가지 preset 음성 및 23개 언어 지원

아리(Aria), 노바(Nova), 루나(Luna), 세이지(Sage) 등 여성 음성 4종과 펠릭스(Felix), 밀로(Milo), 아틀라스(Atlas), 오라이온(Orion) 등 남성 음성 4종을 제공합니다. 각 음성은 라이선스 처리된 녹음 파일을 기반으로 하며, 언어 코드를 명시하지 않아도 스크립트에 따라 언어가 자동 감지됩니다.

영어, 한국어, 중국어, 일본어 등 총 23개 언어를 지원합니다. 언어를 명시하지 않으면 입력된 스크립트에 따라 언어가 추론되나, 영어가 기본값으로 적용될 수 있으므로 비영어권 라틴 문자 텍스트의 경우 language 파라미터에 ISO 코드를 설정하는 것이 좋습니다.지원되지 않는 언어로는 베트남어, 인도네시아어, 태국어, 우크라이나어 등이 있습니다.

  • 8가지 preset 음성 (Aria, Nova, Luna, Sage, Felix, Milo, Atlas, Orion)
  • 23개 언어 지원 (한국어, 영어, 중국어 등)
  • 언어 자동 감지 또는 명시적 language 파라미터 설정

실시간에 가까운 생성 속도 (약 25자/초)

긴 텍스트의 경우 약 25자/초의 속도로 생성되며, 짧은 문장도 수 초 내외로 처리됩니다. 4,096자를 초과하는 텍스트는 자동으로 분할되어 생성된 오디오 파일이 연결됩니다. 부하가 걸릴 경우 요청이 큐에 대기될 수 있으므로, 실시간 응답이 필요한 경우 배치 처리를 권장합니다.

  • 약 25자/초의 생성 속도
  • 최대 4,096자 입력 지원 (자동 분할)
  • 큐 기반 처리로 부하 시 대기 가능

주요 기능 및 기술 스펙

에 대한 소리 파동 일러스트레이션: 주요 기능 및 기술 스펙

HomelyVoice는 표준 JSON 형식의 POST 요청을 통해 음성 합성 서비스를 제공합니다. OpenAI SDK 호환 엔드포인트를 활용하여 기존 생태계와 seamless하게 연동할 수 있으며, 스마트 홈 디바이스나 IoT 게이트웨이 시스템에 쉽게 통합할 수 있습니다.

API는 텍스트 입력을 받아 지정된 포맷의 오디오 파일을 반환합니다. 다양한 오디오 포맷과 속도 조절 기능을 지원하여, 각기 다른 디바이스의 미디어 플레이어 및 네트워크 대역폭 요구사항에 맞춰 최적화된 음성 파일을 생성할 수 있습니다.

JSON 기반 POST 요청 (POST /v1/audio/speech)

POST /v1/audio/speech 엔드포인트로 JSON body를 전송합니다. 모델, 입력 텍스트, 음성 선택 등 필요한 파라미터를 포함하여 요청하면, 서버는 처리 결과를 응답으로 돌려줍니다. OpenAI SDK의 base_url만 변경하면 동일하게 작동합니다.

요청 시 모델은 'tts-1' 또는 'tts-1-hd'를 지정합니다. 입력 텍스트는 최대 4,096자까지 가능하며, 이를 초과하는 긴 텍스트는 클라이언트에서 분할하여 여러 요청으로 처리하거나 오디오 파일을 연결해야 합니다. 인증은 Bearer 토큰을 Authorization 헤더에 포함하여 수행합니다.

  • 엔드포인트: POST /v1/audio/speech
  • 인증: Authorization: Bearer tts-...
  • 입력 텍스트 최대 길이: 4,096자
  • 요청 형식: JSON

mp3, wav, opus, flac, pcm 포맷 지원

생성된 오디오 파일은 mp3, wav, opus, flac, pcm 중 하나로 반환됩니다. 디바이스의 성능과 대역폭에 따라 적절한 포맷을 선택하여 사용할 수 있습니다. 일반적으로 대역폭이 제한된 IoT 환경에서는 opus나 mp3가 효율적입니다.

wav와 flac는 무손실 포맷으로 높은 품질이 필요한 경우에 적합합니다. pcm은 raw 데이터로 제공되어 별도의 디코딩 없이 즉시 재생 가능한 장점이 있습니다. 각 포맷은 별도의 추가 비용 없이 선택할 수 있습니다.

속도 조절 (0.25–4.0) 및 언어 코드 설정

속도 파라미터는 0.25에서 4.0 사이에서 설정할 수 있습니다. 기본값은 1.0이며, 이를 통해 음성 생성 속도를 제어할 수 있습니다. 빠른 속도는 짧은 메시지나 알림에, 느린 속도는 상세한 안내나 학습 콘텐츠에 적합합니다.

언어 코드는 선택 사항이지만, 비영어권 언어의 Latin script 텍스트인 경우 명시적으로 설정하는 것이 좋습니다. 언어를 지정하지 않으면 입력된 스크립트에 따라 언어가 추론되나, 영어가 기본값으로 적용될 수 있습니다.

지원 언어 및 음성 목록

에 대한 소리 파동 일러스트레이션: 지원 언어 및 음성 목록

HomelyVoice는 23개 언어를 지원하여 글로벌 스마트 홈 기기의 음성 기능을 확장합니다. 영어, 한국어, 중국어, 일본어 등 다양한 언어를 포괄하며, language 파라미터를 명시적으로 설정하여 라틴 문자 기반 비영어권 텍스트의 인식 정확도를 높일 수 있습니다.

지원되지 않는 언어로는 베트남어, 인도네시아어, 태국어, 우크라이나어 등이 있습니다.

영어, 한국어, 중국어, 일본어 등 23개 언어 지원

아랍어, 독일어, 프랑스어, 힌디어, 러시아어, 스페인어 등 23개 언어를 지원합니다. 각 음성은 모든 지원 언어를 구사하므로, 특정 언어 전용 음성을 선택할 필요 없이 voice 파라미터 하나로 전역 서비스를 구현할 수 있습니다.

  • 지원 언어: Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, Turkish
  • 언어 미지정 시 스크립트 기반 자동 추론 (라틴 문자는 영어로 기본 처리)

Aria, Nova, Luna 등 여성 음성 4종

Aria는 따뜻하고 명확한 내레이터 톤으로 제품 설명에 적합합니다. Nova는 밝고 경쾌한 어조로 알림 소리에 적합하며, Luna는 부드러운 스토리텔링 톤을, Sage는 차분한 안내 톤을 제공합니다. 모든 여성 음성은 23개 언어를 지원합니다.

  • Aria: Warm, clear narrator
  • Nova: Bright, upbeat
  • Luna: Soft, storytelling
  • Sage: Calm, instructional

Felix, Milo, Atlas 등 남성 음성 4종

Felix는 에너지 넘치는 프로모션 톤을, Milo는 친근한 대화형 어조를 제공합니다. Atlas는 중립적인 뉴스 톤으로, Orion은 깊고 다큐멘터리 스타일의 어조를 구현합니다. IoT 기기의 다양한 컨텍스트에 맞는 음성 선택이 가능합니다.

  • Felix: Energetic, promo
  • Milo: Friendly, conversational
  • Atlas: Neutral, news
  • Orion: Deep, documentary

네이버 음성 변환 서비스와의 차별점

에 대한 소리 파동 일러스트레이션: 네이버 음성 변환 서비스와의 차별점

HomelyVoice는 OpenAI SDK 호환 API를 제공하여 스마트 홈 및 IoT 스타트업의 시스템 통합을 단순화합니다. 단일 엔드포인트를 통해 음성 파일을 획득할 수 있어, 복잡한 프로토콜 없이도 대규모 배치 처리가 가능합니다.

네이버 등 타사의 개별 서비스와 달리, HomelyVoice는 API 기반 자동화에 특화되어 있습니다. 클라우드 인프라를 활용하므로 별도의 서버 구축 없이도 트래픽 증가에 유연하게 대응할 수 있으며, 사용량 기반의 명확한 요금 정책을 적용합니다.

API 기반 자동화 및 대규모 배치 처리

RESTful API를 통해 요청을 전송하면 JSON 형식으로 응답이 반환됩니다. 이 방식은 IoT 게이트웨이나 리모컨의 펌웨어 개발 시 표준화된 HTTP 라이브러리로 쉽게 통합할 수 있어, 복잡한 웹훅이나 이벤트 처리 로직을 줄여줍니다.

특히 대용량 텍스트의 경우 4096자 단위로 자동 분할되어 연속된 오디오 파일을 생성하므로, 별도의 전처리 로직을 작성하지 않아도 됩니다. 이는 스마트 스피커의 음성 안내 생성과 같은 반복적인 배치 작업에 적합합니다.

  • OpenAI SDK 호환 POST 엔드포인트 제공
  • 대용량 텍스트 자동 분할 및 연결 기능
  • IoT 디바이스 펌웨어에 표준 HTTP 라이브러리로 통합 가능

클라우드 기반 확장성 및 유연한 가격 정책

HomelyVoice는 구독형 월정액이 아닌, 생성된 문자 수에 따라 과금됩니다. 100만 자당 $10의 요금으로, 초기 개발 단계의 낮은 트래픽부터 서비스 확장기까지 일정하지 않은 사용 패턴에도 유연하게 대응할 수 있습니다.

최소 충전 금액 $5부터 시작할 수 있으며, USDT(TRC-20)로 자동 충전됩니다. 이는 IoT 스타트업의 현금 흐름 관리에 유리하며, 불필요한 고정비를 줄여줍니다.

생성 실패 시 비용이 반환되므로, 테스트 과정에서의 비용 부담이 적습니다. 초기에는 분당 10회까지, 이후 분당 60회까지 요청이 가능하여 점진적인 확장도 지원합니다.

  • 사용량 기반 요금제 (100만 자당 $10)
  • USDT(TRC-20) 자동 충전, 최소 $5
  • 실패 시 비용 반환

스트리밍 없이 파일 단위의 안정적인 제공

HomelyVoice는 스트리밍을 제공하지 않으며, 완성된 오디오 파일을 반환합니다. 이는 네트워크 상태에 따른 끊김 문제 없이, IoT 기기에서 즉시 재생 가능한 안정적인 환경을 제공합니다. 특히 대역폭이 제한된 로컬 네트워크 환경에서 효과적입니다.

mp3, wav, opus, flac, pcm 등 다양한 포맷을 지원하므로, 디바이스의 오디오 엔진에 최적화된 형식으로 파일을 저장하거나 전송할 수 있습니다.

  • 완성된 오디오 파일 단위 반환
  • mp3, wav, opus, flac, pcm 포맷 지원
  • 네트워크 불안정성 최소화

데이터 처리 및 보안

에 대한 소리 파동 일러스트레이션: 데이터 처리 및 보안

HomelyVoice API는 입력 텍스트를 음성으로 변환한 후 즉시 폐기합니다. 생성된 오디오 파일도 서버에 영구 저장하지 않으며, HTTP 응답 스트림을 통해 클라이언트에게만 제공합니다. 불필요한 데이터 누적 없이 효율적인 스토리지를 유지합니다.

요청 로그에는 시간, 문자 수, 상태 코드 등 청구 검증에 필요한 메타데이터만 최소한으로 보관합니다. 텍스트는 학습용 데이터로 사용되지 않으며, 생성된 오디오 역시 학습 목적의 저장소로 저장되지 않습니다.

입력 텍스트는 생성 후 삭제됨

API로 전송된 원문 텍스트는 음성 합성 엔진에서 처리된 후 서버에 보관되지 않습니다. 텍스트는 오직 오디오 생성 과정에만 사용되며, 생성 완료 후 즉시 메모리에서 해제됩니다.

생성된 오디오는 응답으로만 제공, 저장 안됨

생성된 mp3, wav 등의 오디오 파일은 API 응답 페이로드를 통해 즉시 클라이언트에게 전달됩니다. 파일은 API 서버의 영구 스토리지에 저장되지 않으며, 요청자 측에서 직접 저장하지 않는 한 서버에는 흔적이 남지 않습니다.

이 설계는 IoT 기기나 백엔드 시스템에서 오디오 파일을 직접 관리할 수 있게 하여, 서버 저장 공간을 절약하고 데이터 무결성을 보장합니다.

요청 메타데이터는 청구 목적만 보관

요청 시점, 처리된 문자 수, 응답 상태 코드 등 청구 및 과금 검증에 필요한 최소한의 메타데이터만 기록됩니다. 이 데이터는 사용량 확인 및 오류 분석을 위해 유지되지만, 원문 텍스트나 오디오 콘텐츠와는 분리됩니다.

입력 텍스트와 생성된 오디오는 학습용 데이터로 사용되지 않으므로, 고객 데이터의 프라이버시가 안전하게 유지됩니다.

데이터 처리 및 보안

요금제 및 결제 정보

에 대한 소리 파동 일러스트레이션: 요금제 및 결제 정보

HomelyVoice는 복잡한 구독형 요금제 없이, 실제 사용량에 기반한 단순한 종량제 모델을 채택했습니다. 스마트 홈 및 IoT 생태계의 예측 가능한 비용 구조를 지원하며, 월 정액이나 최소 사용량 제한이 없습니다.

계정 잔액은 만료되지 않으며, 필요 시 언제든지 충전하여 사용할 수 있습니다. 기업 또는 스타트업의 규모에 따라 유연하게 확장 가능한 가격 정책을 제공합니다.

100만 자당 $10 ($0.01/1,000자)

요청당 4,096자까지 처리할 수 있으며, 공백과 구두점을 포함해 계산합니다. 생성된 음성 파일의 품질은 모델(tts-1 또는 tts-1-hd)에 따라 동일하게 유지되며 추가 비용이 발생하지 않습니다.

실패 시 청구 반환

음성 합성 프로세스 중 오류가 발생하여 요청이 실패한 경우, 해당 사용량에 대한 요금은 전액 반환됩니다. 정상적으로 완료된 요청에만 과금되므로, IoT 디바이스의 안정적인 음성 피드백 제공에 불확실성을 줄일 수 있습니다.

USDT(TRC-20) 기반 자동 충전

결제 방식은 TRON 네트워크(TRC-20) 기반 USDT로만 운영됩니다. 최소 충전 금액은 $5이며, 송금 후 자동으로 잔액이 반영됩니다. 신용카드, PayPal, 세금 계산서 발급은 제공되지 않습니다.

신용카드 등록이나 구독 관리가 필요 없으며, API 키 발급 시 $0.50의 무료 체험 크레딧(약 50,000자)이 제공됩니다. 이는 Google 로그인 시에만 적용됩니다.

  • 최소 충전 금액: $5
  • 결제 수단: USDT (TRC-20)
  • 충전 처리 시간: 수분 내 자동 반영
  • 구독형 요금제: 없음

API 사용 제한 및 성능

에 대한 소리 파동 일러스트레이션: API 사용 제한 및 성능

API 키당 분당 60회 요청이 허용되지만, 신규 계정이나 추가 충전 전에는 분당 10회로 제한됩니다. IoT 디바이스의 대량 음성 생성 시 이 제한을 고려한 설계가 필요합니다.

분당 60회 요청 제한 (초기 10회/분)

초기에는 분당 10회 요청이 허용되며, USDT(TRC-20)로 최소 $5 이상 충전 시 제한이 60회로 확대됩니다. 이 제한은 계정당 활성 키 하나에 적용되므로, 동시 처리가 필요할 경우 병렬 키 활용을 고려해야 합니다.

  • 초기 속도: 분당 10회 요청
  • 충전 후 속도: 분당 60회 요청
  • 제한 해제를 위한 최소 충전 금액: $5

대용량 텍스트 자동 분할 및 연결

한 번의 요청으로 전송할 수 있는 텍스트는 최대 4,096자입니다. 이를 초과하는 대용량 텍스트의 경우, 여러 개의 작은 청크로 자동으로 분할하여 개별 오디오 파일을 생성합니다. 이후 생성된 오디오 파일들을 하나의 파일로 연결하여 제공합니다.

  • 최대 텍스트 길이: 4,096자
  • 자동 분할 및 오디오 파일 생성
  • 생성된 오디오 파일들의 자동 연결

큐 기반 처리로 부하 시 대기 가능

부하가 걸릴 경우 요청이 큐에 쌓여 순차적으로 처리됩니다. 일반적으로 생성 속도는 약 25자/초로 실시간에 가깝지만, 요청이 몰릴 경우 대기 시간이 발생할 수 있습니다. IoT 디바이스의 음성 재생 시 이러한 지연을 고려한 UX 설계가 권장됩니다.

  • 부하 시 큐 기반 순차 처리
  • 일반 생성 속도: 약 25자/초
  • 대기 시간 발생 가능

개발자용 통합 가이드

에 대한 소리 파동 일러스트레이션: 개발자용 통합 가이드

API 키 발급 및 연동 가이드를 통해 스마트 홈 IoT 기기에 음성 기능을 신속하게 통합할 수 있습니다.

Python SDK 또는 cURL을 사용하여 텍스트를 음성 파일로 변환하는 워크플로우를 구성하세요.

Google 로그인 또는 이메일로 API 키 발급

get-api-key/ 페이지에서 Google 또는 이메일로 계정을 생성하세요. 발급된 키는 계정당 하나이며, 필요 시 새 키를 발급하면 기존 키는 즉시 무효화됩니다.

curl 예제 및 Python SDK 연동 방법

OpenAI SDK의 base_url을 https://api.tb7.info/v1로 변경하여 사용하세요. POST /v1/audio/speech 엔드포인트에 JSON 본문(model, input, voice 등)을 전송하면 오디오 파일이 반환됩니다.

Python SDK를 사용하여 간단히 요청을 보내거나, cURL 명령어로 직접 엔드포인트를 호출하여 음성 파일을 생성할 수 있습니다.

에러 코드 및 상태 코드 설명

요청 실패 시 과금은 반환되며, 상태 코드를 통해 오류 유형을 확인하세요. 성공 시 오디오 파일이 응답 본문에 포함되어 반환됩니다.

고객 지원 및 연락처

에 대한 소리 파동 일러스트레이션: 고객 지원 및 연락처

HomelyVoice의 고객 지원은 이메일로만 제공됩니다. 전화나 라이브 채팅 서비스는 없으며, 기술 문의는 공식 문서와 FAQ를 통해 확인하세요.

이메일 기반 지원 (전화/라이브채팅 없음)

긴급 전화 상담이나 실시간 채팅 지원이 없습니다. 모든 문의는 이메일로 접수되어 처리됩니다.

FAQ 및 문서 링크 제공

자주 묻는 질문과 API 문서 링크를 통해 기술적 문제를 빠르게 해결할 수 있습니다. 개발자가 직접 참고할 수 있는 링크를 제공합니다.

API 키 재발급 및 계정 관리

계정 페이지에서 API 키를 언제든지 재발급할 수 있습니다. 새 키 발급 시 이전 키는 즉시 무효화됩니다.

계정 설정은 사이트 내에서 직접 관리할 수 있으며, 별도의 외부 시스템 연동은 필요하지 않습니다.

  • API 키 재발급: 기존 키 즉시 정지
  • 계정 관리: 사이트 내 직접 수행

8개 음성 듣기

아래의 각 샘플은 동일한 문장을 이 API로 생성한 것입니다. 분할된 각 청크의 오디오 파일을 생성한 후, 애플리케이션 단에서 이를 결합하여 최종 음성을 완성할 수 있습니다.

음성 아바타 aria
aria여성
음성 아바타 nova
nova여성
음성 아바타 luna
luna여성
음성 아바타 sage
sage여성
음성 아바타 felix
felix남성
음성 아바타 milo
milo남성
음성 아바타 atlas
atlas남성
음성 아바타 orion
orion남성

23개 언어

모든 음성은 이 언어들을 구사합니다.

출처 및 참고 자료

  1. Wikipedia
  2. MDN: Web Speech API
  3. W3C WAI: making audio and video accessible
  4. openai-node on GitHub
  5. Tether (USDT)
  6. Python documentation
  7. IETF RFC 7845: Ogg Opus
  8. LibriVox public-domain audiobooks
  9. ISO 639 language codes
  10. Creative Commons Attribution 4.0
  11. LibriTTS-R paper (arXiv 2305.18802)
  12. LibriTTS-R corpus (OpenSLR 141)

이 사이트의 다른 콘텐츠