자주 묻는 질문
문자 음성 변환 API란 무엇인가요?
클라우드 기반 텍스트 음성 변환(TTS) API입니다. JSON 형식의 요청을 보내면 텍스트를 오디오 파일로 변환하여 반환합니다. OpenAI SDK와 동일한 요청 구조를 사용하므로, API 키와 base_url만 변경하면 공식 OpenAI SDK를 바로 활용하여 오디오를 생성할 수 있습니다.
출판사에서 이 API를 사용해야 하는 이유는 무엇인가요?
시각적 피로나 학습 장애가 있는 독자를 위해 전자책과 오디오북 콘텐츠를 빠르게 생성할 수 있습니다. API를 통해 텍스트를 음성으로 변환하여 접근성을 높일 수 있으며, 복잡한 설정 없이 효율적으로 오디오 콘텐츠를 제작할 수 있습니다.
지원되는 언어는 무엇인가요?
아랍어, 중국어, 덴마크어, 네덜란드어, 영어, 핀란드어, 프랑스어, 독일어, 그리스어, 히브리어, 힌디어, 이탈리아어, 일본어, 한국어, 말레이어, 노르웨이어, 폴란드어, 포르투갈어, 러시아어, 스페인어, 스와힐리어, 스웨덴어, 터키어 등 23개 언어를 지원합니다. 모든 보이스는 모든 언어로 발음할 수 있습니다.
얼마나 많은 문자를 변환할 수 있나요?
요청당 최대 4,096자까지 변환할 수 있습니다. 이보다 긴 텍스트의 경우, 4,096자 단위로 나누어 각 부분을 변환한 후 오디오 파일을 연결하여 사용합니다. 이는 효율적인 처리를 위한 권장 방식입니다.
오디오 파일 형식은 어떻게 되나요?
mp3, wav, opus, flac, pcm 형식을 지원합니다. 요청 시 response_format 필드를 통해 원하는 형식을 지정할 수 있으며, 변환된 오디오 파일은 요청 응답을 통해 반환됩니다.
보이스는 어디에서 가져온 것인가요?
LibriTTS-R(CC BY 4.0) 데이터셋과 LibriVox의 퍼블릭 도메인 오디오북 녹음에서 파생된 라이선스된 녹음을 기반으로 합니다. 각 생성된 오디오 파일에는 인공 음성임을 나타내는 무음의 워터마크가 포함되어 있습니다.
데이터는 저장되나요?
입력 텍스트는 오디오 생성에만 사용되며 학습에는 사용되지 않습니다. 생성된 오디오는 응답으로 반환되며 저장되지 않습니다. 요청 메타데이터(시간, 문자 수, 상태)는 청구 목적으로 유지됩니다.
스트리밍이 지원되나요?
스트리밍, WebSocket, 실시간 부분 오디오는 지원되지 않습니다. 요청은 순차적으로 처리되며, 완료 시 전체 오디오 파일이 반환됩니다. 실시간 오디오 스트리밍이 필요한 경우 별도의 구현이 필요합니다.
SSML을 지원하나요?
SSML은 지원되지 않습니다. 발음 사전이나 사용자 정의 발음 사전도 제공되지 않습니다. 텍스트를 그대로 입력하여 음성으로 변환하며, 속도나 언어 설정만 조정할 수 있습니다.
로봇 목소리가 아닌가요?
라이선스된 녹음 데이터를 기반으로 한 보이스를 사용합니다. 8가지 presets(aria, nova, luna, sage, felix, milo, atlas, orion)이 제공되며, 자연스러운 음성을 제공합니다. 각 오디오 파일에는 인공 음성임을 나타내는 워터마크가 포함됩니다.
어떤 결제 수단을 사용하나요?
TRON 네트워크(TRC-20)의 USDT만 지원합니다. 최소 5달러 이상 충전 시 자동으로 크레딧이 추가됩니다. 신용카드, PayPal, 구독, 세금 계산서는 제공되지 않으며, 잔액은 만료되지 않습니다.
무료 체험은 어떻게 하나요?
Google로 로그인하면 7일 동안 유효한 0.50달러의 무료 크레딧(약 50,000자)이 제공됩니다. 이메일과 비밀번호로 계정을 생성한 경우 무료 체험 크레딧이 기본 제공되지 않습니다.
API 키는 어떻게 발급받나요?
사이트의 /get-api-key/ 페이지에서 Google 또는 이메일과 비밀번호로 가입하면 API 키를 발급받을 수 있습니다. 계정은 사이트별로 독립적으로 관리되며, 새 키를 발급하면 이전 키는 즉시 무효화됩니다.
기술 지원은 어떻게 받나요?
이메일로만 지원이 제공됩니다. 전화나 라이브 채팅은 제공되지 않습니다. 기술적인 문제나 문의사항이 있을 경우 이메일을 통해 연락할 수 있습니다.
첫 번째 요청
curl
curl https://api.tykitys.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출판 접근성, API로 해결하기
출판물 접근성을 API로 해결합니다. Tykitys Access는 텍스트를 음성으로 변환하는 API를 제공하여, 시각적 피로나 학습 장애가 있는 독자들이 콘텐츠에 쉽게 접근할 수 있도록 돕습니다.
빠르고 정확한 음성 변환으로 출판사가 전자책 오디오화 작업을 효율적으로 수행할 수 있습니다. 복잡한 기술적 절차 없이 API를 통해 오디오 콘텐츠를 생성하세요.
텍스트를 오디오로
단순한 텍스트 파일을 고품질의 오디오 파일로 변환합니다. API를 통해 JSON 형식의 요청을 보내면, MP3, WAV, OPUS, FLAC, PCM 등 원하는 형식의 오디오 파일을 받습니다.
4096자까지의 텍스트를 한 번에 처리할 수 있으며, 긴 문서는 자동으로 분할되어 연결됩니다. 생성 속도는 긴 텍스트의 경우 실시간에 가깝습니다.
읽기 장애 독자를 위한 솔루션
읽기 장애가 있는 독자들은 시각적 피로로 인해 전통적인 텍스트 읽기에 어려움을 겪습니다. 음성으로 변환된 콘텐츠는 이러한 장벽을 낮추고 학습 효율을 높입니다.
23개 언어와 8가지 자연스러운 목소리 옵션을 통해 다양한 독자에게 최적의 청취 경험을 제공합니다. language 파라미터를 지정하면 해당 언어의 정확한 발음을 보장할 수 있습니다.
- 시각적 피로 감소
- 학습 장애 지원
- 23개 언어 지원
전자책 오디오화
출판사는 전자책에 오디오 버전을 추가하여 콘텐츠의 가치를 높일 수 있습니다. API를 통해 대량의 텍스트를 빠르게 오디오로 변환하여 시장에 출시할 수 있습니다.
기존의 오디오북 제작 과정보다 훨씬 빠르고 비용 효율적입니다. 별도의 인력이나 장비 없이도 확장 가능한 오디오 콘텐츠를 구축하세요.
지원 언어와 목소리
Tykitys Access API는 전 세계 23개 언어의 텍스트를 자연스러운 음성으로 변환합니다. 출판물이 다양한 독자에게 접근 가능하도록 지원 언어를 확보하세요.
8가지 사전 설정 목소리 중 출판물의 톤에 맞는 음성을 선택하세요. 각 목소리는 명확한 발음과 일관된 품질을 제공합니다.
23개 언어 지원
영어, 한국어, 일본어, 중국어 등 23개 언어를 지원합니다. 읽기 장애 독자가 선호하는 언어로 콘텐츠를 제공하세요.
- 영어, 한국어, 일본어, 중국어, 프랑스어, 독일어, 스페인어, 이탈리아어
- 아랍어, 덴마크어, 핀란드어, 그리스어, 히브리어, 힌디어, 말레이어
- 노르웨이어, 폴란드어, 포르투갈어, 러시아어, 스와힐리어, 스웨덴어, 터키어
8가지 사전 설정 목소리
아리아, 노바, 루나, 세이지, 펠릭스, 미로, 아틀라스, 오리온 등 8가지 목소리를 제공합니다. 각 목소리는 특정 톤과 분위기를 제공합니다.
- 아리아: 따뜻하고 명확한 내레이터
- 노바: 밝고 역동적인 톤
- 루나: 부드럽고 이야기 중심
- 세이지: 차분하고 교육적
- 펠릭스: 에너지 넘치는 홍보 톤
- 미로: 친근하고 대화체
- 아틀라스: 중립적이고 뉴스 스타일
- 오리온: 깊고 다큐멘터리 톤
언어별 맞춤 발음
언어 코드를 지정하면 해당 언어의 정확한 발음을 보장합니다. 예를 들어, 한국어 텍스트에는 한국어 발음을 적용하여 자연스러운 청취 경험을 제공합니다.
간단한 API 연동
Tykitys Access API는 OpenAI의 speech 엔드포인트와 동일한 JSON 형식을 따르므로, 공식 OpenAI SDK를 그대로 활용할 수 있습니다. base_url만 변경하면 바로 연동이 완료됩니다.
오픈AI SDK 호환
공식 OpenAI SDK를 사용 중이라면 base_url을 https://api.tykitys.info/v1로 수정하고 API 키만 설정하면 바로 작동합니다. 별도의 복잡한 설정 없이 동일한 코드 구조로 음성을 생성할 수 있습니다.
curl 예제 제공
/docs/ 페이지에서 바로 복사할 수 있는 curl 명령어 예제를 제공합니다. GET /v1/voices로 사용 가능한 목소리를 확인하고, POST로 음성을 생성하는 과정을 빠르게 테스트해 보세요.
JSON 요청 형식
요청 본문에는 model, input, voice, response_format 필드가 필요합니다. model은 tts-1 또는 tts-1-hd를 선택하며, 최대 4096자까지 입력할 수 있습니다. API 키는 Authorization 헤더에 Bearer 형식으로 포함합니다.
신뢰할 수 있는 품질
출판물에서 텍스트를 오디오로 변환할 때 가장 중요한 것은 청취자의 신뢰입니다. Tykitys Access는 생성된 모든 오디오 파일에 합성 음성임을 나타내는 비가청 워터마크를 포함하여 투명성을 보장합니다.
이러한 기술적 특징은 독자가 콘텐츠의 원천을 명확히 이해할 수 있도록 하며, 출판사의 신뢰도를 높이는 데 기여합니다.
천연 음성 수화
각 오디오 파일에는 합성 음성이라는 것을 나타내는 비가청 워터마크가 포함되어 있습니다. 이는 청취자가 오디오 콘텐츠의 생성 방식을 자연스럽게 인지할 수 있도록 설계된 기능입니다.
라이선스 cleared 보이스
모든 목소리는 라이선스된 녹음 데이터를 기반으로 합니다. LibriTTS-R(CC BY 4.0) 및 LibriVox의 퍼블릭 도메인 오디오북 읽기 자료를 원천으로 사용하여 법적 리스크를 최소화했습니다.
아리아, 노바, 루나, 세이지, 펠릭스, 미로, 아틀라스, 오리온 등 8가지 사전 설정 목소리는 모두 명확한 라이선스 경로를 거쳤습니다.
데이터 비저장 정책
입력된 텍스트는 오디오 생성에만 사용되며 학습 데이터로 저장되지 않습니다. 생성된 오디오 파일은 응답을 통해 즉시 반환되며 서버에 보관되지 않습니다.
청구 정산을 위한 요청 메타데이터(시간, 문자 수, 상태)만 일정 기간 유지됩니다. 따라서 독자들의 개인정보 유출 우려가 적습니다.
간단한 요금제
Tykitys Access는 복잡한 구독 플랜 없이 문자 수 기준 과금을 적용합니다. 100만 문자당 $10로, 공백과 구두점도 문자 수에 포함됩니다. 월정액이나 최소 사용량이 없어, 필요한 만큼만 결제하면 됩니다.
생성에 실패한 요청은 요금이 청구되지 않으며, 이미 충전된 금액은 자동으로 환불됩니다. 이는 API 호출의 안정성을 보장하는 기본적인 정책입니다.
문자 수 기준 과금
1,000 문자당 $0.01의 요금이 적용됩니다. 긴 텍스트는 4,096자 단위로 분할되어 처리되며, 각 요청은 별도의 과금 단위로 계산됩니다.
- 100만 문자 = $10
- 공간 및 구두점 포함
- 최소 사용량 없음
실패 시 환불
음성 생성 중 오류가 발생하거나 요청이 실패한 경우, 해당 금액은 즉시 계정 잔액으로 반환됩니다. 중복 청구가 발생하지 않도록 실시간으로 모니터링됩니다.
USDT 결제
결제 수단으로는 USDT(TRC-20)만 지원합니다. 최소 충전 금액은 $5이며, 트론 네트워크 전송 후 몇 분 내에 잔액이 자동 충전됩니다. 카드나 PayPal은 지원되지 않습니다.
- TRC-20 USDT 전용
- 최소 $5 충전
- 자동 충전 (몇 분 소요)

기술적 제한사항
서비스는 안정적이고 예측 가능한 오디오 파일 생성에 중점을 둡니다. 복잡한 구문 분석이나 미세한 억제 제어가 필요하지 않은 표준 텍스트 변환 워크플로우에 적합합니다.
스트리밍 없음
API는 요청 후 응답으로 전체 오디오 파일을 반환합니다. 실시간 스트리밍이나 WebSocket 연결을 지원하지 않습니다.
SSML 미지원
SSML(음성 합성 언어) 태그를 지원하지 않습니다. 단순한 텍스트 입력과 속도, 속도 조절 기능만으로 충분한 경우가 대부분입니다.
로봇 음성 아님
라이선스된 녹음을 기반으로 한 자연스러운 음성을 제공합니다. 8가지 사전 설정된 목소리는 인간이 직접 녹음한 음성을 기반으로 만들어졌습니다.
FAQ 소개
출력 형식과 속도 제한을 포함한 기술적 특징과 계정 관리 팁을 확인하세요.
API 키 발급부터 결제 상태까지의 핵심 정보를 담았습니다.
자주 묻는 질문
4096자 제한이 초과되면 어떻게 되나요? 입력 텍스트가 길면 자동으로 분할되어 이어지는 오디오 파일로 반환됩니다. 각 청크는 최대 4096자까지 처리되며, 전체 길이에 따라 생성 시간이 달라질 수 있습니다.
- 최대 4096자 처리
- 자동 청크 분할
기술 지원
이메일로 문의하세요. 채팅이나 전화 번호는 제공하지 않습니다. 기술적인 오류나 API 연동 시 문제가 발생하면 지원 팀이 확인 후 답변드립니다.
- 이메일 지원 전용
- 빠른 응답 보장
계정 관리
API 키를 재발급하면 이전 키는 즉시 무효화됩니다. 보안을 위해 주기적인 키 변경이 권장됩니다. 잔액은 만료되지 않으며, USDT 충전 후 자동 반영됩니다.
- 키 재발급 시 이전 키 종료
- 만료 없는 잔액
시작하기
무료 체험 kredyt($0.50)로 API를 먼저 테스트해 보세요. Google 계정으로 로그인하면 즉시 5만 자 분량의 음성을 생성할 수 있습니다.
무료 체험
Google 계정으로 로그인하면 즉시 $0.50의 크레딧이 제공됩니다. 이 금액으로 약 50,000자의 텍스트를 음성으로 변환해 볼 수 있으며, 7일 동안 유효합니다.
API 키 발급
‘API 키 발급’ 페이지에서 Google 또는 이메일로 계정을 만드세요. 생성된 키를 사용하여 OpenAI SDK 호환 방식으로 요청을 보내면 됩니다.
- 한 계정당 활성 키는 1개입니다.
- 새 키를 발급하면 이전 키는 즉시 정지됩니다.
문서 읽기
연동 방법을 빠르게 파악하려면 문서 페이지를 참조하세요. curl 예제와 함께 JSON 요청 형식이 제공되어 개발 시간을 단축할 수 있습니다.
문의하기
문자 음성 변환 API에 대한 기술적 문의나 계정 관련 문제는 이메일로 처리됩니다. 전화나 실시간 채팅 지원은 제공하지 않으므로, 자세한 설명이 필요한 경우 텍스트로 남겨주세요. 답변은 신속하게 처리됩니다.
지원 팀은 API 연동 오류, 목소리 선택, 또는 과금 관련 질문에 대해 명확하게 안내합니다. 복잡한 기술 사항도 이해하기 쉬운 언어로 전달합니다.
이메일 지원
모든 문의는 이메일로 접수됩니다. 별도의 전화번호나 라이브 채팅 창이 없습니다. 기술적 문제나 계정 설정에 대해 궁금한 점이 있으면 언제든지 연락하세요.
빠른 응답을 위해 API 키와 발생 시점을 함께 알려주세요. 지원 팀이 해당 로그를 확인하여 정확한 해결책을 제시합니다.
- 이메일로 문의 가능
- 전화 및 라이브 채팅 없음
링크
API 문서와 가격 정보는 상단 메뉴에서 확인할 수 있습니다. API 키 발급 페이지에서는 실시간 잔액과 사용량을 관리할 수 있습니다.
기술 문서에는 curl 예제와 SDK 연동 방법이 자세히 나와 있습니다. 필요한 링크를 통해 빠르게 정보를 얻으세요.
- API 문서
- API 키 발급 페이지
- 가격 정보 페이지
소셜 미디어
현재 공식 소셜 미디어 계정은 운영하지 않습니다. 최신 업데이트나 공지사항은 이메일로 안내됩니다. 사이트 내 공지란을 통해 주요 소식을 확인하세요.
소셜 미디어보다는 이메일을 통한 직접 소통을 선호합니다. 더 명확하고 상세한 답변을 원하시면 이메일을 이용해 주세요.
- 소셜 미디어 계정으로 공지 발송
8개 음성 듣기
아래의 각 샘플은 동일한 문장을 이 API로 생성한 것입니다. 짧은 문장은 몇 초, 긴 텍스트는 실시간 생성 속도에 맞춰 처리되며, 부하가 걸리면 요청이 큐에 쌓일 수 있습니다.
23개 언어
모든 음성은 이 언어들을 구사합니다.
출처 및 참고 자료
- Wikipedia
- openai-node on GitHub
- LibriTTS-R corpus (OpenSLR 141)
- Python documentation
- W3C WAI: making audio and video accessible
- IETF RFC 7845: Ogg Opus
- Creative Commons Attribution 4.0
- OpenAI API reference: create speech
- MDN: Web Speech API
- LibriTTS-R paper (arXiv 2305.18802)
- Tether (USDT)
- LibriVox public-domain audiobooks
