법률 문서 TTS API는 무엇인가요?

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

이 페이지에서는 gen189.info의 TTS API가 법률 문서 처리에 어떻게 활용되는지 단계별로 안내합니다. API 키 발급부터 요청 전송, 결과 수신까지의 전체 워크플로우와 가격 정책, 기술적 특징을 확인하실 수 있습니다.

복잡한 법률 용어와 긴 문장을 정확하고 명확한 음성으로 변환하는 방법을 배우세요. OpenAI SDK 호환성, 지원 언어 및 음성 프리셋, 데이터 보안 정책과 한계점을 통해 제품 팀이 API를 효율적으로 통합할 수 있도록 구체적인 정보를 제공합니다.

법률 문서 TTS API는 무엇인가요?

자주 묻는 질문

TTS API란 무엇인가요?

텍스트를 입력하면 오디오 파일을 반환하는 클라우드 TTS API입니다. POST 요청으로 모델을 지정하고 음성을 생성할 수 있습니다. OpenAI SDK와 호환되며, base_url만 변경하면 바로 연동할 수 있습니다.

법률 문서에 특화된 이유는?

복잡한 법률 용어와 긴 문장도 정확하고 명확한 음성으로 변환하기 위해 설계되었습니다. 4096자까지 입력 가능하며, 긴 문장은 자동으로 분할하여 이어 붙입니다. 이는 법률 문서의 접근성을 높이는 데 최적화된 워크플로우입니다.

어떤 언어를 지원하나요?

영어, 한국어, 일본어 등 23개 언어를 지원합니다. 아라비아어부터 스와힐리어까지 다양합니다. 지원하지 않는 언어는 베트남어, 인도네시아어 등입니다. 언어를 명시하지 않으면 스크립트에 따라 추측되지만, 정확성을 위해 명시적으로 설정하는 것이 좋습니다.

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

/get-api-key/ 페이지에서 Google 또는 이메일로 가입하면 API 키를 발급받습니다. 계정은 사이트별로 독립적이며, 기존 키는 새 키 발급 시 즉시 정지됩니다. 키는 인증 헤더에 Bearer 방식으로 포함하여 사용합니다.

가격은 어떻게 결정되나요?

100만 자당 $10의 요금이 부과됩니다. 공백과 구두점도 문자 수에 포함됩니다. 실패한 요청은 요금이 부과되지 않으며 전액 환불됩니다. 월 구독이나 최소 사용량이 없으며, 사용한 만큼만 지불하는従量制 모델입니다.

스트리밍이 가능한가요?

스트리밍이나 WebSocket을 통한 실시간 부분 오디오 제공은 지원되지 않습니다. 전체 오디오 파일이 생성된 후 응답으로 반환됩니다. 긴 텍스트의 경우 분할된 파일들이 이어져 제공되지만, 실시간 스트리밍 기능은 현재 없습니다.

SSML을 지원하나요?

SSML(Speech Synthesis Markup Language)을 지원하지 않습니다. 속도 조절은 speed 파라미터로, 언어는 language 파라미터로 설정합니다. 발음 사전이나 감정 태그 같은 고급 마크업 기능은 현재 제공되지 않습니다.

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

고객용 커스텀 보이스 클로닝은 제공되지 않습니다. 8가지 미리 설정된 음성(Aria, Nova 등) 중 하나를 선택하여 사용합니다. 자체적으로 음성을 업로드하거나 맞춤형 음성을 디자인할 수 있는 기능은 현재 없습니다.

전화 지원이 가능한가요?

전화 지원은 제공되지 않습니다. 모든 지원은 이메일을 통해서만 이루어집니다. 실시간 채팅이나 전화번호 안내도 없으며, 기술적 문의나 계정 문제는 이메일을 통해 처리됩니다.

공인 인증서가 있나요?

SOC 2, HIPAA 등 공식 인증서는 제공되지 않습니다. SLA나 가동 시간 보장도 없습니다. 데이터는 생성 목적으로만 사용되며 학습에 사용되지 않지만, 별도의 법적 인증서 보유 여부는 확인되지 않습니다.

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

입력 텍스트는 오디오 생성에만 사용되며 학습 데이터로 사용되지 않습니다. 생성된 오디오는 응답으로 반환되며 저장되지 않습니다. 청구 목적으로 요청 메타데이터(시간, 문자 수, 상태)만 유지됩니다.

오디오 파일은 저장되나요?

생성된 오디오 파일은 응답을 통해 즉시 반환되며 서버에 저장되지 않습니다. 입력 텍스트도 오디오 생성 외의 목적으로 사용되지 않습니다. 요청 기록은 청구 및 감사 목적으로만 보관됩니다.

에러가 발생하면 어떻게 하나요?

합성 실패 시 요금이 전액 환불됩니다. 일반적으로 400 또는 500 에러 코드가 반환되며, 이를 확인하여 요청 파라미터를 수정하거나 잠시 후 재시도하세요. 실패한 요청은 비용 차감되지 않습니다.

속도 조절은 어떻게 하나요?

request body의 speed 파라미터를 사용하여 0.25에서 4.0 사이로 속도를 조절할 수 있습니다. 기본 속도는 1.0이며, 법률 문서의 가독성을 위해 약간 늦춘 속도를 설정할 수도 있습니다.

형식은 어떻게 선택하나요?

response_format 파라미터로 mp3, wav, opus, flac, pcm 중 하나를 선택할 수 있습니다. 일반적인 사용에는 mp3가 적합하며, 고음질이 필요하면 wav나 flac을 선택하세요.

한도는 어떻게 되나요?

키당 분당 60회 요청이 가능합니다. 첫 충전 전에는 분당 10회로 제한됩니다. 텍스트는 요청당 최대 4096자까지 입력 가능하며, 이를 초과할 경우 여러 요청으로 분할하여 처리해야 합니다.

충전은 어떻게 하나요?

TRON 네트워크(TRC-20)의 USDT로만 충전할 수 있습니다. 최소 충전 금액은 $5이며, 이체 후 몇 분 내에 자동으로 크레딧이 충전됩니다. 신용카드나 PayPal은 지원되지 않습니다.

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

Google으로 가입 시 $0.50의 무료 크레딧(약 50,000자)이 7일 동안 제공됩니다. 이메일과 비밀번호로 가입한 계정은 무료 체험 크레딧이 없습니다. /get-api-key/ 페이지에서 가입하면 자동으로 적용됩니다.

API 연동은 어려운가요?

OpenAI SDK와 호환되므로 base_url만 변경하면 쉽게 연동할 수 있습니다. curl 예제를 제공하며, JSON 형식의 요청으로 모델을 지정하고 텍스트를 입력하면 오디오 파일을 받을 수 있어 개발이 간편합니다.

SDK 호환성은 어떻게 되나요?

공식 SDK는 없으나, OpenAI SDK와 호환됩니다. base_url을 https://api.gen189.info/v1로 변경하고 API 키를 설정하면 기존 OpenAI 코드와 동일한 방식으로 사용할 수 있습니다.

데이터 보안은 어떻게 되나요?

입력 텍스트는 오디오 생성 외에는 사용되지 않으며 학습 데이터로 활용되지 않습니다. 생성된 오디오는 저장되지 않습니다. 요청 메타데이터는 청구 목적으로만 유지되며, 별도의 보안 인증서는 제공되지 않습니다.

서비스 약관은 어디에서 볼 수 있나요?

서비스 약관은 /about/ 페이지에서 확인할 수 있습니다. 데이터 처리 정책, 충전 조건, 사용 제한 등이 명시되어 있습니다. 추가적인 법적 고지사항은 해당 페이지를 통해 제공됩니다.

고객 지원은 어떻게 받나요?

이메일을 통해 고객 지원을 받을 수 있습니다. 전화나 라이브 채팅은 제공되지 않습니다. 계정 문제나 기술적 문의는 이메일로 접수되며, 가능한 한 빠르게 답변을 드립니다.

연계 서비스는 무엇인가요?

별도 연계 서비스는 제공되지 않습니다. 텍스트를 오디오로 변환하는 TTS API 기능만 제공합니다. 번역, 자막 생성, 비디오 편집 등의 파이프라인은 포함되지 않습니다. 필요한 경우 자체적으로 통합해야 합니다.

음성 preset은 어떻게 선택하나요?

voice 파라미터에 8가지 프리셋 중 하나를 지정합니다. Aria, Nova, Luna 등 여성 보이스와 Felix, Milo 등 남성 보이스 중 법률 문서에 적합한 톤을 선택하세요.

언어 감지는 어떻게 작동하나요?

language 파라미터를 설정하지 않으면 스크립트에 따라 언어가 추측됩니다. 라틴 문자 텍스트는 기본적으로 영어로 처리됩니다. 법률 문서의 정확한 발음을 위해 language 파라미터에 ISO 코드를 명시적으로 지정하는 것이 좋습니다.

에러 코드는 무엇인가요?

HTTP 상태 코드가 반환됩니다. 429는 rate limit 초과, 400은 잘못된 파라미터를 의미합니다. 실패 시에는 요금이 부과되지 않으며, 응답 본문에 에러 상세 정보가 포함됩니다.

재시도는 어떻게 하나요?

에러 코드를 확인하고 파라미터를 수정한 후 동일한 API 엔드포인트로 다시 POST 요청을 보내세요. 429 에러가 발생하면 분당 60회 제한을 고려하여 요청 간격을 조절하세요. 실패한 요청은 요금이 차감되지 않습니다.

연결 서비스는 무엇인가요?

연계 서비스는 별도로 제공되지 않습니다. TTS API 기능만 제공하며, 음성 합성 후 후처리나 다른 서비스와의 자동 연동은 지원되지 않습니다. 개발자가 직접 API를 호출하여 워크플로우를 구성해야 합니다.

서비스 약관은 어디에서 볼 수 있나요?

서비스 약관은 /about/ 페이지에서 확인할 수 있습니다. 데이터 처리 정책, 충전 조건, 사용 제한 등이 명시되어 있습니다. 추가적인 법적 고지사항은 해당 페이지를 통해 제공됩니다.

고객 지원은 어떻게 받나요?

이메일을 통해 고객 지원을 받을 수 있습니다. 전화나 라이브 채팅은 제공되지 않습니다. 계정 문제나 기술적 문의는 이메일로 접수되며, 가능한 한 빠르게 답변을 드립니다.

연계 서비스는 무엇인가요?

연계 서비스는 별도로 제공되지 않습니다. TTS API 기능만 제공하며, 음성 합성 후 후처리나 다른 서비스와의 자동 연동은 지원되지 않습니다. 개발자가 직접 API를 호출하여 워크플로우를 구성해야 합니다.

TTS API의 기본 개념

에 대한 소리 파동 일러스트레이션: TTS API의 기본 개념

TTS API는 입력된 텍스트를 오디오 파일로 변환하는 클라우드 서비스입니다. POST 요청으로 JSON 데이터를 전송하면, 서버가 음성을 생성하여 응답합니다. 이 과정은 웹 애플리케이션이나 백엔드 시스템에서 직접 호출하여 자동화할 수 있습니다.

법률 문서는 긴 문장과 복잡한 용어를 포함합니다. API는 이를 단일 엔드포인트로 처리하며, 텍스트가 4096자를 넘을 경우 자동으로 분할하여 연결합니다. 이를 통해 법적 문서의 접근성을 기술적으로 해결합니다.

텍스트를 음성으로 변환

TTS API는 텍스트를 오디오 파일로 변환하는 클라우드 서비스입니다. POST 요청으로 JSON 데이터를 전송하면, 서버가 음성을 생성하여 응답합니다. 이 과정은 웹 애플리케이션이나 백엔드 시스템에서 직접 호출하여 자동화할 수 있습니다.

API를 통한 자동화

OpenAI SDK와 호환되는 구조로, base_url만 변경하면 기존 라이브러리를 사용할 수 있습니다. 이는 기존 시스템과의 통합을 단순화합니다. API 키를 통해 인증하고, 생성된 오디오를 즉시 수신하여 저장할 수 있습니다.

법률 문서의 특성

법률 문서는 긴 문장과 복잡한 용어를 포함합니다. API는 이를 단일 엔드포인트로 처리하며, 텍스트가 4096자를 넘을 경우 자동으로 분할하여 연결합니다. 이를 통해 법적 문서의 접근성을 기술적으로 해결합니다.

법률 문서에 적합한 이유

에 대한 소리 파동 일러스트레이션: 법률 문서에 적합한 이유

법률 문서는 복잡한 구조와 정확한 용어 사용이 필수적입니다. HyeongSeo TTS API는 긴 문장도 명확하게 발음하여, 복잡한 법률 조항이나 계약서 내용을 사용자가 쉽게 이해할 수 있도록 돕습니다.

명확한 발음 요구

법률 문서의 핵심은 정확한 의미 전달입니다. 우리 API는 각 음절과 어휘를 선명하게 처리하여, 오해의 소지가 있는 발음 오류를 최소화합니다.

긴 문장 처리 능력

한 번의 요청으로 최대 4096자까지 처리할 수 있어, 긴 조항도 끊김 없이 생성할 수 있습니다. 4096자를 초과할 경우 자동으로 분할하여 연결하므로, 문서의 흐름을 자연스럽게 유지할 수 있습니다.

전문 용어 이해도

법률 특유의 긴 문장과 전문 용어도 자연스러운 속도로 변환합니다. 특히 한국어와 영어를 포함한 23개 언어에서 일관된 품질을 제공하여, 복잡한 법률 문서의 접근성을 높입니다.

주요 기능 소개

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

API는 23개 언어를 지원하며, 한국어, 영어, 중국어 등 법률 문서의 주요 언어를 모두 다룹니다. 언어를 명시하지 않아도 스크립트 기반으로 자동으로 감지되지만, 비영어권 라틴 문자 텍스트의 경우 정확한 인식을 위해 언어 코드를 지정하는 것이 권장됩니다.

속도는 0.25에서 4.0까지 조절할 수 있어 복잡한 법률 조항의 정확한 청취나 빠른 정보 확인에 유연하게 대응합니다. 오디오 형식으로는 mp3, wav, opus, flac, pcm 중 선택 가능하여 다양한 시스템에 통합할 수 있습니다.

여러 언어 지원

23개 언어를 지원하며 한국어, 영어, 중국어, 일본어, 독일어 등 주요 언어를 모두 다룹니다. 언어 필드를 비워두면 입력 텍스트의 문자 기반 언어가 자동으로 감지되지만, 비영어권 라틴 문자 텍스트의 경우 정확한 인식을 위해 언어 ISO 코드를 명시적으로 설정하는 것이 좋습니다. 베트남어, 태국어 등 미지원 언어는 현재 제공되지 않습니다.

지원 언어: Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, Turkish.

  • 23개 언어 지원
  • 언어 자동 감지 기능
  • 비영어권 라틴 문자 텍스트 명시적 언어 설정 권장

속도 조절 기능

속도 파라미터를 0.25에서 4.0까지 조절할 수 있습니다. 법률 문서의 복잡한 문장을 천천히 확인하거나, 일반적인 내용을 빠르게 처리하는 등 사용 목적에 맞춰 발화 속도를 최적화할 수 있습니다. 기본값은 1.0이며, 4.0배속에서도 명확한 발음이 유지됩니다.

  • 속도 범위: 0.25 ~ 4.0
  • 명확한 발음 유지
  • 사용 목적별 최적화 가능

다양한 오디오 형식

mp3, wav, opus, flac, pcm 형식을 지원합니다. mp3는 저장 공간 효율성과 호환성이 뛰어나며, wav와 flac은 무손실 품질이 필요할 때 적합합니다. pcm은 실시간 처리에 유용합니다. 각 형식은 API 응답에서 바로 제공되며 별도 변환 과정이 필요 없습니다.

선택 가능한 형식: mp3, wav, opus, flac, pcm

  • mp3, wav, opus, flac, pcm 지원
  • 저장 공간과 품질 요구사항에 따른 선택 가능

사용 방법 요약

에 대한 소리 파동 일러스트레이션: 사용 방법 요약

API 키 발급부터 오디오 수신까지, 법률 문서 TTS API의 핵심 사용 흐름을 요약합니다. 복잡한 설정 없이 간단한 API 호출로 음성 생성을 자동화할 수 있습니다.

API 키 발급

사이트의 /get-api-key/ 페이지에서 Google 또는 이메일로 계정을 생성하세요. 생성된 계정 페이지에서 고유 API 키를 확인하고, 기본 제공 curl 예시를 통해 바로 연동 테스트를 진행할 수 있습니다.

요청 전송

POST https://api.gen189.info/v1/audio/speech 엔드포인트로 JSON 요청을 전송합니다. Authorization 헤더에 Bearer 토큰을 포함하고, 모델, 입력 텍스트, 음성, 형식 등 필수 파라미터를 설정하세요. 텍스트는 4,096자 제한 내에서 전송해야 합니다.

오디오 수신

요청 처리가 완료되면 생성된 오디오 파일이 응답 본문으로 반환됩니다. mp3, wav, opus 등 원하는 형식을 지정하여 수신할 수 있으며, 긴 문장의 경우 자동으로 분할 처리되어 이어지는 오디오 데이터를 얻을 수 있습니다.

기술적 특징

에 대한 소리 파동 일러스트레이션: 기술적 특징

API는 OpenAI 스키마를 따르므로 기존 SDK를 그대로 사용할 수 있습니다. base_url만 변경하면 됩니다.

JSON 형식의 요청을 통해 모델을 지정하고, 텍스트와 음성 설정을 보냅니다.

OpenAI SDK 호환

공식 OpenAI SDK를 그대로 사용하실 수 있습니다. base_url을 https://api.gen189.info/v1로 변경하고 API 키를 설정하면 즉시 연동됩니다. 별도의 학습이나 복잡한 설정 없이 기존 코드베이스를 유지하며 서비스를 구축할 수 있습니다.

  • 기존 OpenAI SDK 라이브러리 호환
  • base_url 변경만으로 연동 가능
  • 별도 SDK 불필요

JSON 기반 요청

POST 엔드포인트로 JSON 형식의 데이터를 전송합니다. model, input, voice, response_format, speed 등 필수 필드를 포함하여 요청을 보내면, 처리 결과로 오디오 파일이 반환됩니다. 4096자를 초과하는 긴 문장은 클라이언트 측에서 분할하여 전송해야 합니다.

  • JSON 요청 형식 준수
  • 필수 필드: model, input, voice
  • 최대 입력 길이 4096자

배치 처리 방식

긴 법률 문서의 경우, 4096자 단위로 텍스트를 분할하여 여러 요청을 보냅니다. 각 요청에 대한 오디오 파일을 수신한 후 클라이언트에서 이어 붙여야 합니다. 요청은 순차적으로 처리되므로, 대용량 처리 시 큐 대기 시간이 발생할 수 있습니다.

  • 4096자 단위 분할 전송
  • 수신 오디오 파일 병합 필요
  • 순차 처리로 인한 큐 대기 가능

가격 및 결제

에 대한 소리 파동 일러스트레이션: 가격 및 결제

문서 길이에 따라 유연하게 비용을 지불하는 구조입니다. 100만 문자당 10달러로, 공백과 문장 부호도 문자 수에 포함됩니다. 요청이 실패한 경우 요금이 반환되므로 불필요한 지출을 방지할 수 있습니다.

구독이나 월정액 없이 필요할 때만 충전하여 사용합니다. Google 계정으로 로그인하면 7일 동안 0.50달러의 무료 체험 크레딧을 제공하며, 이메일 기반 계정은 체험 크레딧 없이 생성됩니다.

문자 수 기반 과금

100만 문자당 10달러의 명확한 과금 기준을 따릅니다. 생성된 오디오 파일은 서버에 저장되지 않으므로, 요청할 때마다 실제 사용량만 청구됩니다.

실패한 요청에는 요금이 부과되지 않습니다. 이는 API 호출 실패 시 요금이 전액 반환됨을 의미하므로, 안정적인 비용 예측이 가능합니다.

  • 100만 문자당 $10 ($0.01/1,000자)
  • 공백 및 문장 부호 포함 과금
  • 실패 시 전액 환불

무료 체험 제공

Google 계정으로 로그인하면 7일 동안 0.50달러의 체험 크레딧이 제공됩니다. 이는 약 50,000자의 텍스트를 테스트할 수 있는 양입니다.

이메일과 비밀번호로 생성된 계정은 체험 크레딧이 없으며, 즉시 충전 후 사용을 시작해야 합니다.

USDT 충전

트론 네트워크(TRC-20)의 USDT로만 충전이 가능합니다. 최소 충전 금액은 5달러이며, 송금 후 몇 분 안에 자동으로 잔고가 반영됩니다.

카드, PayPal, 구독 제도, 세금 계산서 발행이 없으므로 간편한 결제가 가능합니다. 잔액은 만료일이 없으며 영구적으로 유지됩니다.

  • TRON 네트워크(TRC-20) USDT 전용
  • 최소 충전 금액: $5
  • 자동 입금, 만료 없음

데이터 보안

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

입력 텍스트는 오직 음성 생성에만 사용됩니다. 생성 후 오디오 파일은 응답으로 반환되며 저장되지 않습니다. 학습이나 기타 용도로 데이터가 사용되지 않습니다.

입력 데이터 사용 목적

텍스트는 음성 변환 프로세스에만 사용됩니다. 생성된 오디오 파일은 응답으로 전달되며 서버에 저장되지 않습니다. 사용된 텍스트는 모델 학습이나 기타 용도로 활용되지 않습니다.

오디오 파일 보관 여부

생성된 오디오 파일은 요청 응답으로 반환된 후 저장되지 않습니다. 파일은 일시적으로 처리되어 사용자에게 전달됩니다.

메타데이터 관리

요청 시간, 문자 수, 상태와 같은 메타데이터는 청구 목적으로 유지됩니다. 이 데이터는 음성 생성과는 별도로 관리됩니다.

한계점 안내

에 대한 소리 파동 일러스트레이션: 한계점 안내

HyeongSeo TTS API는 실시간 오디오 스트리밍을 제공하지 않습니다. 대신 API는 전체 오디오 파일이 생성된 후 응답으로 반환됩니다. 긴 법률 문서의 경우, 분할 생성 후 연결하는 방식이 적합합니다.

이 구조는 안정적인 파일 전송과 정확한 크기 예측에 유리합니다. 실시간성이 필요한 대시보드 알림보다는, 문서 생성 후 다운로드하거나 저장하는 워크플로우에 최적화되어 있습니다.

스트리밍 미지원

API는 오디오 스트리밍을 지원하지 않습니다. 요청 완료 후 전체 파일이 반환되므로, 실시간 청취용으로는 적합하지 않습니다. 대신 배치 처리에 최적화되어 있습니다.

  • 전체 파일 반환 방식
  • 배치 처리에 적합

SSML 미지원

SSML을 지원하지 않습니다. 음성 속도는 speed 파라미터로 조절할 수 있습니다. 전문 용어 발음 변경은 현재 불가능합니다.

  • 속도 조절만 가능
  • 세부 억양 제어 불가

커스텀 클로닝 없음

고객이 자신의 목소리를 업로드하여 복제하는 커스텀 클로닝 기능을 제공하지 않습니다. 8가지 미리 설정된 음성 중 하나를 선택하여 사용합니다. 고유한 보이스 디자인이나 사용자 지정 음성 생성은 현재 스케줄에 없습니다.

한계점 안내

지원 언어 목록

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

API는 총 23개 언어를 지원합니다. 주요 언어는 영어, 한국어, 일본어, 중국어, 독일어, 프랑스어, 스페인어 등이며, 아랍어부터 스와힐리어까지 다양하게 포괄합니다. 법률 문서의 국제적 활용에 적합합니다.

특정 언어가 지원되지 않는 경우, 해당 언어로 생성된 오디오는 제공되지 않습니다. 베트남어, 인도네시아어, 태국어, 우크라이나어, 루마니아어, 체코어, 벵골어 등은 현재 지원 대상에서 제외됩니다.

23개 언어 지원

지원 대상 언어 목록은 Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, Turkish 총 23개국 언어입니다. 어떤 음성 프리셋이라도 이 모든 언어를 구사합니다.

  • Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, Turkish

한국어 포함

한국어는 공식 지원 언어 목록에 명확히 포함되어 있습니다. 한국어로 작성된 법률 조항이나 계약서 텍스트를 입력하면 자연스러운 한국어 음성으로 변환됩니다. 한국어 음성 생성 시 별도의 추가 비용이나 제한 사항이 없습니다.

언어 자동 감지

language 파라미터를 생략하면 시스템이 텍스트의 문자를 분석하여 언어를 자동 추정합니다. 라틴 문자 텍스트의 경우 기본적으로 영어로 간주되므로, 영어가 아닌 라틴 문자 기반 언어(예: 한국어 로마자 표기, 프랑스어 등)를 사용할 때는 반드시 language 파라미터에 ISO 코드를 명시해야 합니다. 한글과 같은 비라틴 문자는 자동으로 감지됩니다.

음성 preset 설명

에 대한 소리 파동 일러스트레이션: 음성 preset 설명

8가지 음성 프리셋은 법률 문서의 다양한 톤에 맞춰 설계되었습니다. 각 음성은 명확한 발음과 자연스러운 리듬을 제공하여 긴 문장이나 복잡한 용어도 명확하게 전달합니다.

여자 음성 4종

aria는 따뜻하고 명확한 내레이션 톤으로, nova는 밝고 활기찬 느낌을 줍니다. luna는 부드러운 스토리텔링에 적합하며, sage는 차분하고 교육적인 맥락에서 효과적입니다.

  • aria: 따뜻하고 명확한 내레이터
  • nova: 밝고 활기찬 톤
  • luna: 부드럽고 스토리텔링 중심
  • sage: 차분하고 교육적

남자 음성 4종

felix는 에너지가 넘치는 프로모션용, milo는 친근한 대화형 톤을 제공합니다. atlas는 중립적인 뉴스 스타일이며, orion은 깊고 다큐멘터리 같은 분위기를 연출합니다.

  • felix: 에너지 넘치는 프로모션
  • milos: 친근하고 대화체
  • atlas: 중립적인 뉴스 스타일
  • orion: 깊고 다큐멘터리 톤

음성 특징 비교

모든 음성은 LibriTTS-R 데이터셋 기반으로 합니다. 필요에 따라 속도를 0.25배에서 4.0배까지 조절하여 가청성을 높일 수 있습니다.

에러 처리 방법

에 대한 소리 파동 일러스트레이션: 에러 처리 방법

API 요청 중 오류가 발생하면 응답 본문에 에러 정보가 반환됩니다. 실패한 요청은 요금이 부과되지 않으므로 안심하고 재시도할 수 있습니다.

오류의 원인은 인증 실패, 텍스트 길이 초과, 또는 서버 과부하 등 다양합니다. 제공된 에러 코드를 확인하여 원인을 파악한 후 적절한 조치를 취해야 합니다.

에러 코드 목록

주요 에러 코드로는 인증 실패(401), 리밋 초과(429), 요청 본문 오류(400)가 있습니다. 500번대는 서버 내부 오류를 의미하며, 이는 일시적인 상태이므로 잠시 후 재시도해야 합니다.

  • 400: Bad Request - 텍스트 형식 또는 파라미터 오류
  • 401: Unauthorized - API 키가 잘못되었거나 만료됨
  • 429: Too Many Requests - 분당 60회 요청 한도 초과
  • 500: Internal Server Error - 서버 내부 처리 오류

해결 방안

401 에러 발생 시 API 키를 다시 확인하거나 새 키를 발급받으세요. 429 에러는 1분 후 재시도하거나 토큰을 추가하여 리밋을 늘릴 수 있습니다. 텍스트가 4096자를 초과했으면 분할하여 전송하세요.

  • API 키 확인 및 재생성
  • 리밋 상향 또는 대기 후 재시도
  • 텍스트 분할 전송

재시도 전략

지연 후 재시도(exponential backoff) 전략을 사용하는 것이 좋습니다. 서버 부하가 높을 때 즉시 재시도하면 429 에러가 발생할 수 있으므로, 적절한 시간 간격을 두고 반복 요청하세요. 실패 시에도 과금되지 않으므로 안전한 재시도가 가능합니다.

연계 서비스

에 대한 소리 파동 일러스트레이션: 연계 서비스

API는 단일 기능이 아닌 생태계의 일부입니다. 법률 문서 관리 시스템과 연동하면 긴 계약서나 판례를 자동으로 오디오 파일로 변환할 수 있습니다. 생성된 오디오는 검색과 접근성을 동시에 개선합니다.

법률 문서 관리 시스템

문서 생성 API와 연동하여 텍스트 입력 시 자동으로 음성을 생성하고 저장합니다. 복잡한 법률 용어가 포함된 긴 문장도 정확히 처리하여 문서의 접근성을 높입니다.

접근성 도구

WCAG 기준을 준수하는 웹 사이트에 오디오 플레이어를 추가할 수 있습니다. 시각 장애인이나 읽기 장애가 있는 사용자가 법률 정보를 쉽게 들을 수 있도록 합니다.

  • 웹 접근성 가이드라인 준수 지원
  • 오디오 플레이어 통합 용이

오디오 변환 서비스

이미 제작된 텍스트 기반 법률 자료를 오디오 형식으로 변환하는 데 활용합니다. MP3, WAV, FLAC 등 다양한 형식으로 출력되어 다양한 플랫폼에서 재생 가능합니다.

고객 지원

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

저희는 전화나 실시간 채팅 지원 없이 이메일로만 소통합니다. 복잡한 법률 문서의 TTS 변환 과정에서 발생하는 기술적 문제나 계정 관련 문의는 [email protected]로 보내주세요. 신속하고 정확한 답변을 드리겠습니다.

이메일 지원

모든 문의는 이메일을 통해 처리됩니다. 제품 팀은 법률 문서와 API 기술의 교차점에서 고객의 문제를 해결합니다.

기술 문서 링크

API 사용법, 엔드포인트 설명, SDK 예제는 /docs/ 페이지에서 확인할 수 있습니다. OpenAI SDK 호환성 및 코드 예제를 참고하세요.

문의 방법

기술 지원 및 계정 문의는 [email protected]로 연락하세요. 답변은 신속하게 제공되지만, 실시간 채팅은 제공되지 않습니다.

서비스 약관

에 대한 소리 파동 일러스트레이션: 서비스 약관

HyeongSeo API는 Google 또는 이메일/비밀번호로 계정을 생성하여 이용합니다. 각 사이트별 계정은 독립적이며, 신규 키 발급 시 이전 키는 즉시 무효화됩니다. 월 구독이나 최소 사용량이 없으며, USDT(TRC-20)로 충전한 잔액은 만료되지 않습니다.

API 키는 계정당 하나만 활성화되며, 실패한 요청은 요금이 부과되지 않습니다. 서비스 약관은 언제든지 변경될 수 있으며, 변경 사항이 적용되기 전까지 기존 조건이 유효합니다.

이용 조건

계정은 사이트별로 독립적으로 관리됩니다. Google 로그인이나 이메일/비밀번호로 생성된 계정은 서로 연결되지 않으며, 각 사이트에서 별도의 키를 사용합니다.

한 계정당 하나의 활성 API 키를 가집니다. 새 키를 생성하면 이전 키는 즉시 정지됩니다. 월정액이나 최소 사용량이 없으며, USDT 충전 잔액은 영구 유효합니다.

  • 계정은 사이트별 독립 관리
  • API 키는 계정당 1개만 활성
  • 충전 잔액은 만료되지 않음

데이터 정책

입력 텍스트는 오디오 생성 목적으로만 사용되며 학습에 활용되지 않습니다. 생성된 오디오 파일은 응답으로 반환되며 저장되지 않습니다.

청구 및 과금을 위해 요청 시간, 문자 수, 상태 등의 메타데이터가 보관됩니다. 이 메타데이터는 다른 용도로 사용되지 않습니다.

  • 입력 텍스트는 학습용이 아님
  • 오디오 파일은 저장되지 않음
  • 요청 메타데이터는 청구용 보관

면책 조항

서비스는 "있는 그대로" 제공되며, 명시적 또는 묵시적 보증이 없습니다. SLA나 가동시간 보장이 없습니다.

서비스 중단, 데이터 손실, 오디오 품질 이슈에 대해 제한된 책임만 부담합니다. 법적 책임은 서비스 이용으로 인한 직접 손해로 제한됩니다.

  • 명시적/묵시적 보증 없음
  • SLA 및 가동시간 보장 없음
  • 제한된 책임 범위 적용

8개 음성 듣기

아래의 각 샘플은 동일한 문장을 이 API로 생성한 것입니다. 실시간성이 필요한 대시보드 알림보다는, 문서 생성 후 다운로드하거나 저장하는 워크플로우에 최적화되어 있습니다.

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

23개 언어

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

출처 및 참고 자료

  1. Wikipedia
  2. openai-python on GitHub
  3. Python documentation
  4. IETF RFC 7845: Ogg Opus
  5. curl documentation
  6. TRON developer hub: TRC-20
  7. LibriTTS-R corpus (OpenSLR 141)
  8. W3C WAI: making audio and video accessible
  9. openai-node on GitHub
  10. LibriTTS-R paper (arXiv 2305.18802)
  11. OpenAI API reference: create speech
  12. Node.js documentation

이 사이트의 다른 콘텐츠