자주 묻는 질문
TTS API란 무엇인가요?
Tykitys Access는 텍스트를 음성 파일로 변환하는 클라우드 TTS API입니다. 텍스트를 보내면 mp3, wav 등 오디오 파일이 반환됩니다. 출판사가 전자책이나 오디오북 콘텐츠를 빠르게 생성할 수 있도록 설계되었습니다. OpenAI SDK와 호환되며, 간단한 HTTP 요청만으로 통합할 수 있어 기술 부하 없이 접근성 콘텐츠를 제작할 수 있습니다.
어떻게 작동하나요?
POST 요청으로 텍스트와 모델, 보이스를 지정하면 오디오 파일이 반환됩니다. 길이가 긴 텍스트는 4,096자 단위로 자동 분할되어 생성된 오디오가 연결됩니다. 최대 4.0배 속도 조절이 가능하며, 실패한 요청은 요금이 청구되지 않습니다. API 키를 사용하여 인증하고, 생성된 음성 파일을 수신하여 워크플로우에 통합합니다.
출판사와 관련이 있나요?
네, 출판사를 위해 설계되었습니다. 전자책이나 오디오북 콘텐츠를 빠르고 정확하게 생성할 수 있도록 돕습니다. 텍스트를 음성으로 변환하여 시각적 피로가 있는 독자들이 접근할 수 있도록 합니다. 대량 텍스트 처리를 지원하여, 출판사의 콘텐츠 제작 워크플로우를 효율적으로 지원합니다.
접근성과 관련이 있나요?
시각적 피로와 학습 장애가 있는 독자들을 위해 텍스트를 음성으로 변환합니다. 다양한 언어와 보이스를 지원하여 접근성을 높입니다. 오디오북 형식으로 콘텐츠를 제공하면 독자들의 읽기 부담을 줄일 수 있습니다. API를 통해 출판사가 손쉽게 접근성 콘텐츠를 제작할 수 있도록 지원합니다.
스트리밍이 지원되나요?
스트리밍은 지원되지 않습니다. 요청을 보내면 전체 오디오 파일이 응답으로 반환됩니다. WebSocket이나 실시간 부분 오디오 제공 기능이 없으며, 표준 HTTP 응답을 통해 오디오 데이터를 받습니다. 긴 텍스트의 경우 분할된 오디오 파일이 연결되어 반환되므로, 스트리밍이 필요한 경우 클라이언트 측에서 처리해야 합니다.
SSML을 지원하나요?
SSML은 지원되지 않습니다. 텍스트에 마크업을 추가할 수 없으며, 간단한 속도 조절과 보이스 선택만 가능합니다. 발음 사전이나 감태 태그, 음성 설계 기능도 없습니다. 순수 텍스트 입력으로 음성을 생성하므로, 복잡한 음성 제어보다는 간단한 텍스트 변환에 적합합니다.
로봇 목소리가 아닌가요?
LibriTTS-R 및 LibriVox의 라이선스된 녹음 기반 보이스를 사용합니다. aria, nova, luna 등 8가지의 자연스러운 presets를 제공하며, 각 보이스는 고유한 톤과 특성을 가집니다. 생성된 오디오에는 합성 음성을 나타내는 무음의 워터마크가 포함되어 있어 신원 식별이 가능합니다.
언어는 어떻게 설정하나요?
language 파라미터에 ISO 코드를 지정합니다. 지정하지 않으면 스크립트 기반으로 추측되나, 비영어권 라틴 문자 텍스트의 경우 명시적 설정이 권장됩니다. 아랍어, 한국어, 프랑스어 등 23개 언어를 지원하며, 모든 보이스가 모든 언어를 구사합니다. 지원하지 않는 언어는 베트남어, 인도네시아어 등입니다.
보이스는 어떻게 선택하나요?
voice 파라미터에 8가지 preset 중 하나를 지정합니다. aria, nova, luna, sage, felix, milo, atlas, orion 중 선택 가능합니다. 각 보이스는 여성 또는 남성 톤으로 구분되며, 따뜻한 내레이터부터 신나는 프로모션 톤까지 다양한 스타일을 제공합니다. GET /v1/voices 엔드포인트를 통해 사용 가능한 보이스 목록을 확인할 수 있습니다.
요금은 어떻게 되나요?
100만 자당 $10의 요금이 부과됩니다. 공백과 구두점도 문자 수에 포함됩니다. 실패한 요청은 요금이 청구되지 않습니다. Google 로그인 시 $0.50의 무료 체험 크레딧이 제공되며, TRON 네트워크를 통한 USDT 충전으로 잔액을 충전할 수 있습니다. 월 구독이나 최소 사용량이 없습니다.
데이터는 저장되나요?
입력 텍스트는 오디오 생성에만 사용되며 학습에 사용되지 않습니다. 생성된 오디오는 응답으로 반환되며 저장되지 않습니다. 요금 청구 및 검증을 위해 요청 메타데이터(시간, 문자 수, 상태)가 보관됩니다. 개인 정보 보호를 위해 오디오 파일은 영구 저장되지 않습니다.
API 키는 어떻게 얻나요?
/get-api-key/ 페이지에서 Google 또는 이메일과 비밀번호로 가입합니다. 가입 후 대시보드에서 API 키를 확인하고 사용할 수 있습니다. 하나의 계당 하나의 활성 키가 있으며, 필요시 새 키를 발급하면 기존 키는 즉시 무효화됩니다. 키는 Authorization 헤더에 Bearer 토큰 형태로 사용됩니다.
에러는 어떻게 처리하나요?
합성 실패 시 요금이 전액 환불됩니다. API 응답에서 에러 코드를 확인하고, 필요한 경우 요청을 재시도합니다. 문자 수 제한(4,096자)을 초과할 경우 분할 요청을 권장합니다. 속도 제한(분당 60회)을 초과하면 요청이 대기열에 들어갈 수 있으므로, 적절한 대기 시간을 설정하세요.
기술 지원은 어떻게 받나요?
이메일을 통한 지원만 제공됩니다. 전화나 라이브 채팅, SLA, 온라인 상태 보장, 기업 계약, 온프레미스 설치 옵션은 제공되지 않습니다. 기술 문서와 API 엔드포인트 설명을 참고하여 문제를 해결할 수 있으며, 추가 문의는 이메일로 가능합니다.
정의
Tykitys Access의 TTS API는 텍스트를 자연스러운 음성으로 변환하는 클라우드 서비스입니다. 시각적 피로나 학습 장애가 있는 독자를 위해 출판사가 전자책이나 오디오북 콘텐츠를 빠르고 정확하게 생성할 수 있도록 설계되었습니다.
텍스트 음성 변환
텍스트 음성 변환(TTS)은 컴퓨터가 텍스트 데이터를 인간의 음성으로 변환하는 기술입니다. Tykitys Access는 8가지의 다양한 보이스와 23개 언어를 지원하여 콘텐츠의 접근성을 높입니다.
- 텍스트를 음성으로 변환
- 23개 언어 지원
- 8가지 보이스 옵션
API란?
API(응용 프로그램 프로그래밍 인터페이스)는 서로 다른 소프트웨어 시스템이 데이터를 교환할 수 있도록 하는 연결고리입니다. Tykitys Access API는 RESTful 방식을 따르며, 표준 HTTP 요청을 통해 텍스트를 음성 파일로 변환할 수 있습니다.
- RESTful API 구조
- 표준 HTTP 요청 지원
- 간단한 연동 가능
클라우드 서비스
Tykitys Access는 클라우드 기반 서비스로, 별도의 하드웨어 설치 없이 웹 브라우저나 코드에서 바로 사용할 수 있습니다. API 호출 시 서버에서 음성이 생성되어 반환되므로, 복잡한 처리 과정 없이 효율적으로 콘텐츠를 제작할 수 있습니다.
- 클라우드 기반 서비스
- 별도 설치 불필요
- 실시간 음성 생성
작동 원리
Tykitys Access TTS API는 클라우드 기반 텍스트 음성 변환 서비스입니다. HTTP POST 요청을 통해 텍스트를 입력하면, API는 이를 처리하여 오디오 파일을 반환합니다. 별도의 SDK 설치 없이 표준 HTTP 클라이언트나 OpenAI SDK를 변경하여 사용할 수 있습니다.
요청 보내기
요청은 https://api.tykitys.info/v1/audio/speech 엔드포인트로 POST 방식으로 전송합니다. JSON 본문에는 변환할 input 텍스트, 사용할 model (tts-1 또는 tts-1-hd), voice (8가지 프리셋 중 선택), response_format (mp3, wav 등)을 포함합니다. 텍스트는 최대 4096자까지 가능하며, 토큰 기반 인증이 필요합니다.
- 엔드포인트: POST /v1/audio/speech
- 입력: JSON 형식의 텍스트 (최대 4096자)
- 인증: Authorization: Bearer tts-...
처리 과정
요청이 수신되면 텍스트가 음성 합성 엔진으로 전달됩니다. 처리 속도는 일반적으로 실시간과 유사하지만(초당 약 25자), 짧은 문장 생성에는 몇 초이 걸릴 수 있습니다. 서버 부하가 높으면 요청이 큐에 대기될 수 있습니다. 4096자를 초과하는 긴 텍스트는 자동으로 분할되어 처리됩니다.
오디오 반환
합성이 완료되면 지정된 형식(mp3, wav, opus 등)의 오디오 파일이 응답 본문에 반환됩니다. 생성된 오디오는 응답으로 직접 전달되며 서버에 장기 저장되지 않습니다. 실패한 요청의 경우 요금이 부과되지 않습니다.
사용 사례
출판사는 Tykitys Access API를 통해 원고를 텍스트로 변환해 전자책과 오디오북을 빠르고 정확하게 생성할 수 있습니다. 4,096자 제한 내의 텍스트를 보내면 음성 파일이 반환되며, 긴 원고는 분할 처리해 연결할 수 있습니다.
API를 연동하면 대량 텍스트도 대략 실시간 속도로 처리됩니다. 이를 통해 출판사는 제작 시간을 단축하고 접근성이 필요한 독자에게 더 쉽게 콘텐츠를 제공할 수 있습니다.
전자책
전자책 리더기는 텍스트 읽기 기능을 지원하지만, API를 활용하면 오디오 트랙을 직접 포함할 수 있습니다. 짧은 구문은 몇 초, 긴 텍스트는 실시간 속도에 맞춰 생성되므로, 사용자는 원하는 형식으로 콘텐츠를 배포할 수 있습니다.
- 4,096자 단위 텍스트 처리
- 오디오 파일 직렬화 지원
오디오북
장르에 따라 8가지 보이스 중 적합한 음성을 선택할 수 있습니다. 뉴스 스타일이나 이야기 톤을 원한다면 atlas나 luna와 같은 보이스를 사용해 일관된 오디오북을 제작할 수 있습니다.
- 8가지 보이스 선택 가능
- 일관된 톤 유지
접근성
시각적 피로나 학습 장애가 있는 독자를 위해 텍스트를 음성으로 변환합니다. 23개 언어를 지원하며, 언어 코드를 명시하면 더 정확한 발음이 가능합니다. 이는 더 많은 독자가 콘텐츠에 접근할 수 있게 돕습니다.
- 23개 언어 지원
- 자동 언어 감지 기능
장점
Tykitys Access API는 텍스트를 음성으로 변환하는 클라우드 서비스입니다. API는 RESTful 구조를 따르며, JSON 형식의 요청을 통해 텍스트를 입력하고 오디오 파일을 반환받습니다. 복잡한 설치나 설정 없이 간단한 HTTP 요청으로 통합할 수 있어 개발자가 신속하게 음성 기능을 구축할 수 있습니다.
API를 통해 생성된 오디오 파일은 MP3, WAV, OPUS, FLAC 등 다양한 형식으로 제공됩니다. 속도 조절 기능과 8가지 보이스 옵션을 활용하여 출판물이나 접근성 콘텐츠의 톤을 세밀하게 조정할 수 있습니다.
빠른 생성
긴 텍스트의 경우 대략 실시간 속도로 오디오가 생성됩니다. 이는 초당 약 25자의 텍스트가 처리된다는 의미로, 짧은 문장이라도 몇 초 이내에 결과를 확인할 수 있습니다. 요청은 순차적으로 처리되며, 부하 상황 시 대기열에 진입할 수 있습니다.
저렴한 가격
가격은 문자 수에 따라 결정되며, 100만 문자당 $10의 요금이 부과됩니다. 이는 1,000자당 $0.01에 해당하며, 공백과 구두점도 문자 수에 포함됩니다. 실패한 요청의 경우 요금이 전액 환불되므로 불필요한 비용이 발생하지 않습니다.
초기 사용자를 위해 Google 로그인 시 $0.50의 무료 체험 크레딧(약 50,000자)이 제공됩니다. USDT(TRC-20)를 통해 최소 $5부터 충전할 수 있으며, 월 구독이나 추가 요금은 없습니다.
쉬운 연동
API는 OpenAI의 speech 엔드포인트와 동일한 요청 형식을 사용합니다. 따라서 OpenAI SDK를 사용 중이라면 base_url만 변경하여 바로 연동할 수 있습니다. Bearer 토큰을 이용한 인증과 JSON 요청으로 간편하게 오디오 파일을 받을 수 있습니다.
- OpenAI SDK 호환성
- 단순 JSON 요청 구조
- 빠른 통합 가능
한계
Tykitys Access는 실시간 스트리밍이나 웹소켓을 지원하지 않습니다. 텍스트를 한 번에 전송하고 응답으로 오디오 파일을 받는 방식입니다. 짧은 문장은 몇 초, 긴 텍스트는 실시간 생성 속도에 맞춰 처리되며, 부하가 걸리면 요청이 큐에 쌓일 수 있습니다.
SSML이나 발음 사전, 감정 태그 같은 복잡한 음성 제어 기능은 제공되지 않습니다. 대신 8가지 미리 설정된 보이스와 속도 조절로 충분하고 자연스러운 결과를 얻을 수 있습니다. LibriTTS-R 데이터셋과 LibriVox의 공공 도메인 오디오를 기반으로 한 자연스러운 음성입니다.
로봇 음성 아님
완전히 기계적인 목소리가 아닌, LibriTTS-R 데이터셋과 LibriVox의 공공 도메인 오디오를 기반으로 한 자연스러운 음성입니다. 인간 화자의 녹음 데이터를 기반으로 하므로 로봇음성 특유의 딱딱함이 적습니다.
모든 생성 파일에는 합성 음성임을 나타내는 무음의 워터마크가 포함됩니다.
- LibriTTS-R 기반
- 무음 워터마크 포함
언어 지원
Tykitys Access API는 총 23개 언어를 지원합니다. 아랍어, 중국어, 덴마크어, 네덜란드어, 영어, 핀란드어, 프랑스어, 독일어, 그리스어, 히브리어, 힌디어, 이탈리아어, 일본어, 한국어, 말레이어, 노르웨이어, 폴란드어, 포르투갈어, 러시아어, 스페인어, 스와힐리어, 스웨덴어, 터키어가 포함됩니다.
베트남어, 인도네시아어, 태국어, 우크라이나어, 루마니아어, 체코어, 벵골어 등 이 목록에 없는 언어는 지원되지 않습니다.
23개 언어
위 목록의 모든 언어를 API를 통해 명확하게 생성할 수 있습니다. 각 보이스는 지정한 언어에 맞춰 자연스러운 발음과 억양을 제공합니다.
- 아랍어, 중국어, 덴마크어, 네덜란드어, 영어, 핀란드어, 프랑스어, 독일어, 그리스어, 히브리어, 힌디어, 이탈리아어, 일본어, 한국어, 말레이어, 노르웨이어, 폴란드어, 포르투갈어, 러시아어, 스페인어, 스와힐리어, 스웨덴어, 터키어
언어 감지
language 파라미터를 명시하지 않으면 API가 입력 텍스트의 문자를 분석해 언어를 자동으로 추측합니다. 라틴 문자의 텍스트는 기본적으로 영어로 처리되므로, 영어가 아닌 다른 라틴 문자 언어(예: 스페인어, 독일어)를 사용할 때는 반드시 language 파라미터를 설정해야 합니다.
언어 설정
명확한 발음을 위해 request JSON의 language 필드에 ISO 언어 코드를 지정하세요. 이는 오디오북이나 전자책 생성 시 특정 언어의 억양이 유지되도록 보장합니다. 지원되지 않는 언어를 지정한 경우 오류가 발생할 수 있으므로 목록을 참조하세요.

보이스 선택
TTS API는 8가지 미리 설정된 보이스를 제공합니다. 각 보성은 라이선스된 녹음과 퍼블릭 도메인 오디오북을 기반으로 하며, 생성된 오디오 파일에는 합성 음성임을 알리는 무음수 워터마크가 포함됩니다.
8가지 보이스
모든 보이스는 23개 언어를 지원합니다. 특정 언어를 명시하지 않으면 라틴 문자는 영어로, 다른 문자는 해당 스크립트에 따라 자동으로 감지됩니다. 명확한 발음을 위해 비-라틴 문자 텍스트에는 language 매개변수를 설정하는 것이 좋습니다.
- aria: 따뜻하고 명확한 내레이터
- nova: 밝고 경쾌한 톤
- luna: 부드럽고 이야기하는 느낌
- sage: 차분하고 교육적인 어조
- felix: 에너지 넘치는 홍보 스타일
- milo: 친근하고 대화체 스타일
- atlas: 중립적인 뉴스 스타일
- orion: 깊고 다큐멘터리 스타일
성별 구분
총 8개의 보이스는 여성과 남성으로 구분됩니다. 여성 보이스는 aria, nova, luna, sage이며, 남성 보이스는 felix, milo, atlas, orion입니다. 성별에 관계없이 모든 보이스가 모든 23개 언어를 자연스럽게 구사합니다.
톤 설명
각 보이스는 고유한 톤을 가집니다. aria는 따뜻한 내레이션에 적합하며, nova는 밝고 역동적인 콘텐츠에 좋습니다. luna는 부드러운 스토리텔링에, sage는 차분한 설명에 적합합니다. felix는 홍보에, milo는 대화체에 적합하며, atlas는 뉴스에, orion은 다큐멘터리 톤에 적합합니다.
요금제
Tykitys Access는 복잡한 구독이나 최소 사용량 없이 문자 수 기준으로만 요금이 부과됩니다. API를 호출할 때마다 생성된 문자 수에 따라 정산되며, 실패한 요청은 요금이 부과되지 않습니다.
문자 수 기준
가격은 100만 문자당 $10로, 공백과 구두점 포함 1,000자당 $0.01입니다. 월정액이나 Seats가 없어 사용한 만큼만 지불하며, 잔고는 만료되지 않습니다.
USDT 결제
카드는 물론 PayPal이나 VAT 포함 청구서도 없습니다. TRON 네트워크(TRC-20)의 USDT로만 충전하며, 최소 $5부터 충전 가능합니다. 전송 후 몇 분 안에 자동으로 잔고가 반영됩니다.
무료 체험
Google으로 로그인하면 7일간 유효한 $0.50(약 50,000자)의 체험 크레딧이 제공됩니다. 이메일/비밀번호로 가입한 계정은 기본 체험 크레딧 없이 시작됩니다.
데이터 정책
Tykitys Access API는 입력된 텍스트를 오디오 파일로 변환하는 데만 사용합니다. 생성된 오디오는 응답으로 반환되며 별도 저장하지 않습니다.
요청 시간, 문자 수, 상태 같은 기본 데이터는 요금 정산을 위해 유지됩니다.
비저장 정책
생성된 오디오 파일은 서버에 영구 저장되지 않습니다. 요청이 완료되면 응답으로 직접 전달되며, 이후 별도의 백업이나 저장소에는 보관되지 않습니다.
사용 데이터
입력 텍스트는 오디오 생성 목적 외에는 사용되지 않으며 학습 데이터로 활용되지 않습니다.
요청 메타데이터(시간, 문자 수, 상태)는 요금 계산 및 청구 목적으로만 유지됩니다.
보안
데이터는 생성 및 청구 목적에 한정되어 사용됩니다. 추가적인 마케팅이나 제3자 공유는 이루어지지 않습니다.
API 키는 계정당 하나만 활성화되며, 새로운 키 발급 시 이전 키는 즉시 무효화됩니다.
- 입력 텍스트: 오디오 생성 후 별도 저장 안 함
- 요청 메타데이터: 요금 정산용 저장
- 학습 데이터 활용: 없음
기술 지원
Tykitys Access는 전화나 실시간 채팅 대신 이메일로만 지원을 제공합니다. 기술적 문의나 계정 문제 해결은 오직 이메일을 통해서만 진행되며, 별도의 전화 번호나 라이브 채팅 창을 운영하고 있지 않습니다.
이메일 지원
모든 문의는 이메일로 접수됩니다. 빠른 응답을 위해 API 키와 관련 오류 메시지를 함께 알려주시면 더 정확하고 신속하게 처리할 수 있습니다.
문서
상세한 API 설명과 코드 예시는 공식 문서 페이지에서 확인할 수 있습니다. curl 예제와 SDK 설정 가이드가 포함되어 있어 개발자가 즉시 연동을 시작할 수 있습니다.
커뮤니티
독립적인 커뮤니티 포럼은 운영하지 않습니다. 대신 공식 문서와 이메일 지원을 통해 필요한 정보를 제공합니다.
자주 묻는 질문
Tykitys Access API는 텍스트를 음성으로 변환하는 클라우드 서비스입니다. JSON 형식의 요청을 통해 오디오 파일을 생성하며, OpenAI SDK의 base_url만 변경하면 바로 연동할 수 있습니다. 생성된 오디오 파일은 응답으로 즉시 반환되며, 별도 저장되지 않습니다.
API 키
계정당 활성 키는 하나만 유지됩니다. 새 키를 발급하면 이전 키는 즉시 무효화됩니다. 키는 /get-api-key/ 페이지에서 확인하거나 재발급할 수 있습니다.
요청 제한
초기에는 분당 10회, 이후에는 분당 60회의 요청 한도가 적용됩니다. 긴 텍스트는 4096자 단위로 분할되어 처리되며, 큐에 대기할 수 있어 생성 시간이 다소 걸릴 수 있습니다.
에러 처리
합성 실패 시 요금이 전액 환불됩니다. 문자 수 기반 과금이므로 실패한 요청은 비용에 영향을 미치지 않습니다.
8개 음성 듣기
아래의 각 샘플은 동일한 문장을 이 API로 생성한 것입니다. 짧은 문장은 몇 초, 긴 텍스트는 실시간 생성 속도에 맞춰 처리되며, 부하가 걸리면 요청이 큐에 쌓일 수 있습니다.
23개 언어
모든 음성은 이 언어들을 구사합니다.
