박물관 오디오 가이드용 무료 tts API

작성자 뮤지오 편집팀 · 업데이트됨 2026-11-18

박물관 및 관광 산업의 제품 팀을 위한 클라우드 TTS API 페이지입니다. 본 페이지에서는 오디오 가이드 콘텐츠의 대량 생성과 다국어 음성 합성을 위한 API 엔드포인트, 지원되는 8가지 음성 프리셋, 그리고 OpenAI SDK 기반의 기술적 호환성에 대해 안내합니다.

관광 안내 음성 파일 생성부터 다국어 오디오 가이드 배포까지, JSON 기반 REST API를 통한 효율적인 워크플로우를 구축할 수 있습니다. API 키 발급부터 첫 번째 요청 테스트까지의 시작 방법과 데이터 정책, 용도 및 적용 사례를 확인하세요.

박물관 오디오 가이드용 무료 tts API

자주 묻는 질문

무료 tts API란 무엇인가요?

TourVoice는 텍스트를 음성 파일로 변환하는 클라우드 API입니다. 텍스트를 전송하면 오디오 파일이 반환되며, OpenAI SDK와 호환되는 엔드포인트를 제공합니다. 월 구독이나 최소 사용량이 없으며, TRC-20 USDT로만 충전하여 사용량을 지불합니다. 박물관 오디오 가이드 콘텐츠의 효율적인 대량 생성을 위한 안정적인 도구입니다.

박물관 오디오 가이드에 적합한 음성은 무엇인가요?

박물관 콘텐츠에는 'sage'(차분한 안내), 'atlas'(중립적인 뉴스 스타일), 'aria'(따뜻한 내레이터)가 적합합니다. 'nova'는 경쾌한 홍보용에, 'orion'은 다큐멘터리 형식에 적합합니다. 모든 음성은 23개 언어를 지원하므로, 특정 언어의 자연스러운 오디오 가이드 제작에 유연하게 적용할 수 있습니다.

API를 통해 생성된 오디오 파일의 포맷은 무엇인가요?

mp3, wav, opus, flac, pcm 형식을 지원합니다. 각 요청당 최대 4,096자까지 처리 가능하며, 속도 조절(0.25~4.0)도 가능합니다. 생성된 오디오는 응답을 통해 즉시 반환되며, 별도의 저장소 없이 반환됩니다. 다양한 포맷 지원으로 다양한 오디오 가이드 시스템에 쉽게 통합할 수 있습니다.

지원되는 언어는 어떤 것이 있나요?

영어, 한국어, 일본어, 중국어, 프랑스어, 독일어, 스페인어 등 총 23개 언어를 지원합니다. 베트남어, 태국어, 우크라이나어 등은 지원되지 않습니다. 언어를 지정하지 않으면 스크립트에 따라 자동 감지되지만, 비영어권 라틴 문자 텍스트의 경우 명시적 언어 지정을 권장합니다.

무료 체험 크레딧은 어떻게 사용하나요?

Google 로그인 시 $0.50(약 50,000자)의 무료 체험 크레딧이 제공됩니다. 이메일/비밀번호로 가입한 경우 체험 크레딧이 없습니다. 크레딧은 생성이 완료된 후 차감되며, 실패한 요청은 환불됩니다. 체험 기간은 가입일로부터 7일간 유효합니다. 이후 TRC-20 USDT로 충전하여 계속 사용할 수 있습니다.

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

사이트의 /get-api-key/ 페이지에서 Google 또는 이메일/비밀번호로 가입하면 API 키가 발급됩니다. 계당 활성 키는 하나만 존재하며, 필요 시 새 키를 발급할 수 있습니다. 새 키 발급 시 이전 키는 즉시 무효화됩니다. 발급된 키는 Authorization 헤더에 Bearer 토큰 형태로 사용됩니다.

긴 텍스트를 처리하는 방법이 무엇인가요?

한 번의 요청당 최대 4,096자까지 처리할 수 있습니다. 긴 텍스트의 경우 클라이언트에서 여러 부분으로 분할하여 각각 API에 전송한 후, 생성된 오디오 파일들을 연결해야 합니다. 이는 API의 기본 제한 사항으로, 긴 오디오 가이드 제작 시 필수적인 워크플로우입니다.

생성된 오디오 파일의 라이선스는 어떻게 되나요?

음성은 LibriTTS-R(LibriVox 퍼블릭 도메인 오디오북 읽기 기반)을 기반으로 합니다. 생성된 파일에는 합성 음성을 나타내는 무음의 워터마크가 포함됩니다. 입력 텍스트는 학습에 사용되지 않으며, 생성된 오디오는 응답으로 반환 후 저장되지 않습니다.

API의 Rate Limit은 무엇인가요?

키당 분당 60회 요청이 허용됩니다. 첫 충전 전에는 분당 10회로 제한됩니다. 요청은 순차적으로 처리되므로 부하가 걸리면 대기열에 서게 될 수 있습니다. 일반적으로 긴 텍스트는 실시간 속도로 생성되며, 짧은 문장은 몇 초이 걸립니다. 용도별 효율적인 요청 관리가 필요합니다.

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

입력 텍스트는 오디오 생성에만 사용되며 학습 데이터로 활용되지 않습니다. 생성된 오디오는 응답으로 반환되며 서버에 저장되지 않습니다. 청구 목적으로 요청 메타데이터(시간, 문자 수, 상태)만 유지됩니다. 따라서 민감한 오디오 가이드 콘텐츠의 안전한 처리가 가능합니다.

OpenAI SDK와 호환되나요?

요청 구조가 OpenAI 스피치 엔드포인트와 동일하여 공식 OpenAI SDK를 사용할 수 있습니다. base_url을 https://api.playz28.com/v1로 변경하고 사이트 API 키를 사용하면 됩니다. 별도의 전용 SDK나 모바일 SDK는 제공되지 않으며, 평면 HTTP 요청도 직접 사용할 수 있습니다.

오디오 파일에는 워터마크가 있나요?

네, 생성된 모든 오디오 파일에는 합성 음성임을 나타내는 무음의 워터마크가 포함됩니다. 이는 파일이 AI로 생성되었음을 식별하기 위한 것입니다. 별도의 워터마크 제거 기능은 제공되지 않습니다.

고객 지원 연락처는 무엇인가요?

전화 번호나 라이브 채팅이 없으며, 이메일 지원만 제공됩니다. SLA나 가동 시간 보장, 엔터프라이즈 계약, 온프레미스 설치 옵션도 없습니다. 기술적 문제나 청구 관련 문의는 이메일을 통해 처리되며, 응답 시간은 명시되지 않았습니다. 빠른 실시간 지원을 필요로 하는 경우 적합하지 않을 수 있습니다.

무료 tts API의 한계는 무엇인가요?

스트리밍, SSML, 사용자 정의 음성 클로닝, 감정 태그, 음성 디자인 기능이 없습니다. 공식 SDK나 워드프레스 플러그인, 브라우저 확장 프로그램도 제공되지 않습니다. 음성 스피치 투 텍스트, 번역, 더빙 파이프라인도 지원하지 않습니다. 4,096자 제한과 분당 60회 요청 제한이 주요 한계입니다.

첫 번째 요청

curl

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

관광 콘텐츠 제작을 위한 API 설계

에 대한 소리 파동 일러스트레이션: 관광 콘텐츠 제작을 위한 API 설계

TourVoice API는 관광 및 박물관 산업의 제품 팀을 위해 설계된 클라우드 TTS 솔루션입니다. 텍스트를 입력하면 오디오 파일이 생성되며, 단일 요청당 최대 4,096자까지 처리할 수 있습니다. 긴 텍스트의 경우 클라이언트에서 분할하여 여러 요청으로 전송해야 합니다.

API는 JSON 기반의 REST 구조를 따르며, OpenAI SDK와 호환됩니다. 이를 통해 오디오 가이드 콘텐츠의 대량 생성과 다국어 음성 합성을 위한 안정적인 엔드포인트를 제공합니다. 인증은 Bearer 토큰을 통해 이루어지며, 요청 시 model, input, voice 등의 필드를 지정합니다.

오디오 가이드용 텍스트 합성

오디오 가이드용 텍스트 합성

TourVoice API는 관광 및 박물관 산업의 제품 팀을 위해 설계된 클라우드 TTS 솔루션입니다. 텍스트를 입력하면 오디오 파일이 생성되며, 단일 요청당 최대 4,096자까지 처리할 수 있습니다. 긴 텍스트의 경우 클라이언트에서 분할하여 여러 요청으로 전송해야 합니다. 생성된 오디오는 응답으로 직접 반환되며, 서버에 저장되지 않습니다.

API는 JSON 기반의 REST 구조를 따르며, OpenAI SDK와 호환됩니다. 이를 통해 오디오 가이드 콘텐츠의 대량 생성과 다국어 음성 합성을 위한 안정적인 엔드포인트를 제공합니다. 인증은 Bearer 토큰을 통해 이루어지며, 요청 시 model, input, voice 등의 필드를 지정합니다.

다국어 지원 및 언어 감지

TourVoice는 총 23개 언어를 지원합니다. 아랍어, 중국어, 덴마크어, 네덜란드어, 영어, 핀란드어, 프랑스어, 독일어, 그리스어, 히브리어, 힌디어, 이탈리아어, 일본어, 한국어, 말레이어, 노르웨이어, 폴란드어, 포르투갈어, 러시아어, 스페인어, 스와힐리어, 스웨덴어, 터키어를 포함합니다. 모든 음성은 모든 언어를 구사할 수 있습니다.

language 파라미터를 설정하지 않으면 스크립트 기반 언어 감지가 작동합니다. 라틴 문자 텍스트의 경우 기본값이 영어로 설정되므로, 영어가 아닌 라틴 문자 텍스트의 경우 language 파라미터를 명시적으로 설정해야 합니다. 베트남어, 인도네시아어, 태국어, 우크라이나어, 루마니아어, 체코어, 벵골어 등은 지원되지 않습니다.

  • 지원 언어: 아랍어, 중국어, 덴마크어, 네덜란드어, 영어, 핀란드어, 프랑스어, 독일어, 그리스어, 히브리어, 힌디어, 이탈리아어, 일본어, 한국어, 말레이어, 노르웨이어, 폴란드어, 포르투갈어, 러시아어, 스페인어, 스와힐리어, 스웨덴어, 터키어 (총 23개 언어)

API 기반 자동화 워크플로우

TourVoice API는 POST https://api.playz28.com/v1/audio/speech 엔드포인트를 통해 작동합니다. 텍스트를 JSON body로 전송하면 오디오 파일이 반환됩니다. 이는 공식 OpenAI SDK의 base_url을 변경하여 사용할 수 있음을 의미하며, 동일한 요청 형태를 따릅니다. 이는 기존 개발 워크플로우를 유지하면서 TTS 기능을 통합할 수 있게 합니다.

속도 조절은 0.25에서 4.0까지 가능하며, 오디오 형식은 mp3, wav, opus, flac, pcm 중 선택할 수 있습니다. 요청 메타데이터는 청구 목적으로 유지되며, 생성된 오디오 파일은 저장되지 않습니다. 이는 데이터 프라이버시와 효율적인 워크플로우를 위한 설계입니다.

지원되는 음성 presets

에 대한 소리 파동 일러스트레이션: 지원되는 음성 presets

TourVoice API는 박물관 오디오 가이드 제작에 활용 가능한 8가지 음성 프리셋 중 세 가지 여성 음성을 제공합니다. aria, nova, luna는 각각 내레이터, 해설자, 스토리텔러 역할에 최적화되어 있으며, 텍스트 입력 시 voice 파라미터로 선택할 수 있습니다.

이 음성들은 LibriTTS-R 데이터셋의 CC BY 4.0 라이선스를 기반으로 하며, 생성된 오디오 파일에는 인audible 마크가 포함됩니다. 각 음성은 특정 콘텐츠 톤에 맞게 조정되어 있어, 전시 해설의 일관된 음향을 유지하는 데 적합합니다.

Narrator: aria (따뜻한 내레이터)

aria는 따뜻하고 명확한 어조를 가진 내레이터 음성입니다. 박물관 전시물의 상세한 설명이나 역사적 배경을 전달할 때 적합한 명확한 발음과 일정한 속도를 제공합니다. 4096자까지의 텍스트 입력에 안정적으로 반응하며, 교육적인 콘텐츠의 표준 내레이션으로 사용됩니다.

  • 따뜻하고 명확한 내레이터 톤
  • 교육적 콘텐츠에 적합한 명확한 발음
  • 일정한 속도로 안정적 생성

Upbeat: nova (활기찬 해설)

nova는 밝고 상쾌한 에너지를 지닌 해설 음성입니다. 주요 볼거리나 흥미로운facts를 소개할 때 청중의 관심을 유도하기 위해 설계되었습니다. 빠른 템포와 명확한 억양을 유지하여, 복잡한 정보를 효율적으로 전달해야 하는 관광 안내 음성 파일 생성에 적합합니다.

  • 밝고 상쾌한 에너지
  • 관객의 관심을 유도하는 톤
  • 복잡한 정보 전달에 효율적

Storytelling: luna (이야기꾼)

luna는 부드럽고 서사적인 스타일의 이야기꾼 음성입니다. 유적지의 역사적 사건이나 전설을 서사시처럼 들려줄 때 적합합니다. 자연스러운 문장 부호 처리를 제공하여 방문자에게 오디오 가이드 경험을 제공합니다. 긴 텍스트 분할 시에도 일관된 톤을 유지합니다.

  • 부드럽고 서사적인 스타일
  • 역사적 사건 및 전설에 적합
  • 몰입감 있는 오디오 경험 제공

지원 언어 목록

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

TourVoice API는 박물관 및 관광 산업의 다국어 오디오 가이드 제작을 지원합니다. 23개 언어를 지원하며, 모든 음성이 모든 언어를 구사합니다. 언어 코드를 명시하지 않으면 스크립트에 따라 언어가 추론되나, 영어 외 라틴 문자 텍스트의 경우 명시적 지정을 권장합니다.

유럽 언어: 영어, 프랑스어, 독일어 등

영어, 프랑스어, 독일어, 스페인어, 이탈리아어, 포르투갈어, 스웨덴어, 노르웨이어, 덴마크어, 핀란드어, 폴란드어, 그리스어, 터키어, 네덜란드어를 지원합니다.

아시아 언어: 일본어, 한국어, 중국어 등

일본어, 한국어, 중국어(간체/번체 구분 없이 지원), 아랍어, 힌디어, 말레이어, 러시아어, 스와힐리어를 지원합니다. 각 언어의 고유한 발음 특징을 음성 엔진이 반영합니다.

기타 언어: 아랍어, 스페인어, 힌디어 등

위 목록에 없는 베트남어, 인도네시아어, 태국어, 우크라이나어, 루마니아어, 체코어, 벵골어 등은 지원하지 않습니다. 특정 언어가 필요한 경우 API 엔드포인트를 통해 현재 지원되는 언어 목록을 확인하시기 바랍니다.

기술적 호환성

에 대한 소리 파동 일러스트레이션: 기술적 호환성

TourVoice API는 OpenAI SDK의 호환성을 기반으로 구축되었습니다. base_url을 https://api.playz28.com/v1로 변경하고 API 키를 설정하면 기존 OpenAI SDK로 바로 연동할 수 있습니다. REST API와 JSON 기반의 표준화된 요청 구조를 제공하여, 별도의 커스텀 SDK 없이도 다양한 프로그래밍 환경에서 쉽게 통합할 수 있습니다.

OpenAI SDK 연동 지원

공식 OpenAI SDK를 그대로 사용하면서도 base_url만 변경하면 TourVoice API와 연동할 수 있습니다. 이는 기존 인프라에 대한 학습 비용을 최소화하고, 즉각적인 개발 및 테스트를 가능하게 합니다.

JSON 기반 REST API

모든 요청과 응답은 JSON 형식으로 처리됩니다. 텍스트, 음성, 포맷, 속도 등의 파라미터를 JSON body로 전달하면, 생성된 오디오 파일이 응답 본문에 직접 반환됩니다. 서버 측에서 별도의 URL 처리 없이 바로 오디오 파일로 저장하거나 처리할 수 있습니다.

다양한 오디오 포맷 제공

mp3, wav, opus, flac, pcm 등 다양한 오디오 포맷을 지원합니다. 관광 콘텐츠의 저장 공간과 대역폭 요구 사항에 따라 최적의 포맷을 선택할 수 있습니다.

성능 및 속도

에 대한 소리 파동 일러스트레이션: 성능 및 속도

오디오 가이드 생성은 대략 텍스트 1초당 25자에 해당하는 속도로 실시간에 가깝게 처리됩니다. 하지만 짧은 구문의 경우 몇 초의 생성 시간이 필요하며, 요청이 연달아 들어올 경우 큐에서 대기해야 할 수 있습니다. 이는 단일 요청이 순차적으로 처리되기 때문입니다.

실시간 근접 생성 속도

긴 텍스트의 경우 4,096자 단위로 분할하여 합성하고 결과를 연결합니다. 이 방식은 대용량 오디오 가이드 콘텐츠의 효율적인 생성을 가능하게 하며, API의 기본 요청 제한에 맞춰 안정적으로 작업을 수행할 수 있습니다.

긴 텍스트 분할 처리

API 키당 분당 60회 요청이 가능합니다. 초기에는 분당 10회 제한이 적용되므로, 대량 생성 시 적절한 대기 시간을 두고 호출해야 합니다. 추가 충전 후에도 동일한 제한이 유지됩니다.

대시보드 모니터링

계정 대시보드에서는 API 키, 잔액, 남은 문자 수, 사용량 현황을 확인할 수 있습니다.

성능 및 속도

무료 체험 및 시작

에 대한 소리 파동 일러스트레이션: 무료 체험 및 시작

TourVoice은 신규 계정에 한해 7일간 유효한 $0.50의 무료 체험 크레딧을 제공합니다. 이메일 기반 계정 생성 시 이 혜택이 적용되지 않으므로, Google 로그인을 통해 계정 생성 시 즉시 50,000자 분량의 텍스트 합성 권한을 얻으실 수 있습니다.

무료 체험 크레딧 ($0.50)

시작 비용 없이 API의 성능을 검증할 수 있습니다. 생성된 크레딧은 7일 동안 유효하며, 기간 내 사용되지 않은 잔액은 소멸됩니다. 신용카드 등록 절차가 필요하지 않아 부담 없이 테스트 환경에서 오디오 가이드 품질을 확인할 수 있습니다.

  • 무료 체험: $0.50 크레딧 (약 50,000자)
  • 유효 기간: 계정 생성일로부터 7일
  • 조건: Google 로그인 계정 생성 시 제공

간단한 API 키 발급

/get-api-key/ 페이지에서 Google 또는 이메일/비밀번호로 간편하게 가입할 수 있습니다. 인증이 완료되면 대시보드에서 API 키를 즉시 확인할 수 있으며, 필요 시 이전 키를 정지하고 새로운 키를 발급할 수 있습니다. 키는 계정별로 독립적으로 관리됩니다.

  • 지원 로그인: Google 또는 이메일
  • 키 관리: 활성 키 1개 기준, 즉시 교체 가능
  • 할당량: 분당 10회 (최초 충전 전)

첫 번째 요청 테스트

제공된 cURL 예제를 사용하여 오디오 생성 API를 테스트할 수 있습니다. 텍스트 입력 시 4,096자 제한 내에서 오디오 파일이 반환되며, 실패한 요청은 크레딧이 차감되지 않습니다. 이를 통해 박물관 오디오 가이드의 음질과 다국어 지원 성능을 사전에 검증하시기 바랍니다.

  • 엔드포인트: POST /v1/audio/speech
  • 형식: OpenAI SDK 호환 JSON
  • 한도: 요청당 4,096자

데이터 정책

에 대한 소리 파동 일러스트레이션: 데이터 정책

TourVoice API는 입력 텍스트를 오디오로 변환하는 데만 사용하며, 생성된 데이터는 학습용 데이터셋에 포함되지 않습니다. 따라서 고객의 고유한 콘텐츠가 사후 학습이나 모델 개선에 활용되지 않음을 보장합니다.

학습용 데이터 미사용

입력된 텍스트는 오디오 파일 생성 프로세스의 입력값으로만 사용되며, 사후 학습이나 모델 개선 목적으로 저장되지 않습니다. 이는 고객사의 독점적인 콘텐츠가 제3자의 데이터셋에 편입되는 것을 방지합니다.

생성된 오디오 비저장

API 응답을 통해 반환된 오디오 파일은 서버에 영구 저장되지 않습니다. 요청이 완료되면 오디오 데이터는 즉시 처리되어 전송되며, 별도의 보관 또는 재사용을 위한 저장소는 존재하지 않습니다.

billling용 메타데이터 보관

청구 및 과금 확인을 위해 요청 시간, 문자 수, 상태 코드 등의 메타데이터만 유지됩니다. 이는 서비스 이용 내역의 투명성을 보장하고, 불필요한 데이터 보관으로 인한 프라이버시 리스크를 최소화합니다.

용도 및 적용 사례

에 대한 소리 파동 일러스트레이션: 용도 및 적용 사례

TourVoice API는 박물관 및 관광지에서 오디오 가이드 콘텐츠의 효율적인 제작을 위해 설계되었습니다. REST API를 통한 대량 생성으로, 긴 텍스트도 4096자 단위로 분할하여 자동으로 이어붙인 오디오 파일을 생성합니다. 이를 통해 제품 팀은 수동 편집 없이도 일관된 음질과 속도의 오디오 가이드를 대량으로 공급할 수 있습니다.

API는 다양한 오디오 포맷(mp3, wav 등)을 지원하며, 생성된 오디오는 외부 저장소에 보관되지 않습니다. 입력 텍스트는 생성 목적 이외에 학습 데이터로 사용되지 않으므로, 민감한 전시 자료나 저작권이 있는 해설 텍스트도 안전하게 처리할 수 있습니다.

전시 해설 오디오 생성

박물관 전시물의 설명 문구를 텍스트로 입력하면, 지정된 음성(Aria, Luna 등)으로 변환된 오디오 파일을 즉시 받아볼 수 있습니다. 최대 4096자의 텍스트를 한 번에 처리하며, 긴 해설 텍스트는 자동으로 분할되어 이어지는 오디오로 생성됩니다.

생성된 오디오는 오디오 가이드 시스템에 직접 업로드하여 사용할 수 있으며, 실패한 요청은 무료이므로 테스트와 검증 과정이 효율적입니다.

  • 4096자 단위 자동 분할 및 이어붙이기
  • 8가지 사전 정의된 음성 presets 지원
  • 오디오 파일 즉시 다운로드

관광 안내 음성 파일

관광지의 주요 명소나 교통 안내 정보를 음성 파일로 생성하여 모바일 앱이나 웹 사이트에 제공합니다. 단일 요청당 최대 4096자의 텍스트를 처리할 수 있으며, 속도 조절(0.25–4.0배)을 통해 안내의 리듬을 맞출 수 있습니다.

이 서비스는 별도의 서식 언어(SSML)나 복잡한 설정 없이 JSON 기반 REST API로 빠르게 통합할 수 있어, 제품 팀이 빠르게 프로토타입을 구축하고 배포할 수 있습니다.

  • 0.25–4.0배 속도 조절 가능
  • mp3, wav, opus 등 다양한 포맷 지원

다국어 오디오 가이드

23개 언어를 지원하여 동일 텍스트를 여러 언어로 생성하거나, 언어 코드를 명시하여 정확한 발음을 보장할 수 있습니다. 언어를 지정하지 않으면 스크립트에 따라 언어가 감지되지만, 비영어권 언어의 경우 명시적 지정을 권장합니다.

한국의 방문객을 위한 영어 해설이나, 국제 관광객을 위한 한국어/영어/일본어 병행 오디오 가이드 등 다양한 다국어 전략을 API 기반 워크플로우로 구현할 수 있습니다.

  • 23개 언어 지원
  • 언어 코드 명시적 지정 가능
  • 자동 언어 감지 기능

기술 스택 및 호환성

에 대한 소리 파동 일러스트레이션: 기술 스택 및 호환성

TourVoice API는 HTTP REST 프로토콜을 기반으로 설계되어博物馆 및 관광 산업의 기존 IT 인프라와 즉시 연동됩니다. 별도의 전용 SDK나 복잡한 라이브러리 설치 없이 표준 HTTP 클라이언트를 통해 안정적인 통신이 가능합니다.

인증은 Bearer 토큰 방식을 사용하며, 발급된 API 키를 Authorization 헤더에 포함시켜 요청합니다. 이는 OpenAI SDK와의 호환성을 확보하며, Python, JavaScript 등 주요 언어의 기존 HTTP 라이브러리를 즉시 활용할 수 있게 합니다.

HTTP REST API

RESTful 구조를 따르는 API 엔드포인트는 HTTP 메서드와 URI를 통해 자원을 명확히 정의합니다. 박물관의 백엔드 시스템이나 모바일 앱 서버와 표준 HTTP 연결을 통해 오디오 데이터를 주고받을 수 있어, 별도의 커넥터 개발 비용을 절감합니다.

  • 표준 HTTP 메서드 (POST, GET) 지원
  • RESTful URI 구조
  • 광범위한 언어 및 프레임워크 호환성

JSON 요청/응답

모든 요청 본체는 JSON 형식으로 전송되며, 입력 텍스트, 음성 설정, 포맷 옵션 등을 명확하게 전달합니다. 응답 또한 JSON 구조로 처리 상태와 오디오 데이터 URL을 반환하여, 서버 측에서 후처리 없이 바로 오디오 파일로 저장하거나 스트리밍할 수 있습니다.

  • 표준 JSON 요청 본문
  • 구조화된 응답 데이터
  • 개발자 친화적인 데이터 교환 형식

OAuth/Bearer 인증

API 키는 Authorization: Bearer <key> 형식의 헤더를 통해 전송됩니다. 각 계정당 활성 키가 하나씩 관리되며, 필요 시 새 키를 발급하면 이전 키는 즉시 무효화되어 보안성을 유지합니다. 복잡한 OAuth 플로우 없이 직관적인 토큰 방식으로 인증이 처리됩니다.

  • Bearer 토큰 기반 인증
  • 단일 활성 키 관리
  • 즉시적인 키 무효화 지원

8개 음성 듣기

아래의 각 샘플은 동일한 문장을 이 API로 생성한 것입니다. 박물관 전시물의 설명 문구를 텍스트로 입력하면, 지정된 음성(Aria, Luna 등)으로 변환된 오디오 파일을 즉시 받아볼 수 있습니다.

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

23개 언어

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

출처 및 참고 자료

  1. Wikipedia
  2. Creative Commons Attribution 4.0
  3. curl documentation
  4. Python documentation
  5. ISO 639 language codes
  6. FFmpeg documentation
  7. Tether (USDT)
  8. IETF RFC 7845: Ogg Opus
  9. Node.js documentation
  10. openai-node on GitHub
  11. W3C WAI: making audio and video accessible
  12. OpenAI API reference: create speech

이 사이트의 다른 콘텐츠