Blog

수퍼톤 플레이 TTS API 튜토리얼

September 14, 2026

‍

‍

‍

1. API 시작하기

‍

Q. API Key는 어디서 발급받나요?

A. API 콘솔에 로그인하면 서비스 가입 즉시 API Key를 발급받을 수 있습니다. 한 계정당 최대 3개의 Key를 생성해 사용할 수 있으며, 유출 시에는 콘솔에서 삭제 후 재발급이 가능합니다.

‍

‍

‍

Q. API는 어떻게 연동하나요?

A. 발급받은 API Key를 HTTP 헤더에 포함하여 인증 후 요청을 보내면 됩니다. 자세한 연동 방법은 공식 문서를 참고해 주세요.

‍

Q. 사용할 수 있는 보이스는 어디서 확인하나요?

A. Play 보이스 라이브러리 또는 Get/Search Voices API를 통해 보이스 ID와 스타일 정보를 확인할 수 있습니다.

‍

‍

Q. 크레딧 잔액은 어디서 확인하나요?

A. Get Credit Balance API를 호출하거나, 콘솔 또는 Play 마이페이지에서 확인할 수 있습니다.

‍

Q. 음성을 생성하기 전에 길이를 예측할 수 있나요?

A. Predict Duration API를 사용하면, 입력한 텍스트가 몇 초 분량의 오디오로 생성될지 미리 확인할 수 있습니다. 이 API는 크레딧 없이도 호출할 수 있습니다.

‍

‍

‍

‍

2. 자주 묻는 질문

‍

Q. API는 어떻게 결제해 사용하나요?

A. Play와 동일한 크레딧 시스템을 사용합니다. 요금제 구독 또는 단건 충전으로 크레딧을 충전해 사용합니다.

‍

Q. API에서도 클론드 보이스를 사용할 수 있나요?

A. 네. Play에서 생성한 클론드 보이스는 API에서도 동일하게 호출할 수 있습니다. 단, 클론드 보이스 생성은 Play에서만 가능합니다.

‍

Q. Play에서 생성한 음성을 API에서 다시 사용할 수 있나요?

A. 같은 계정에서 생성한 클론드 보이스는 별도 설정 없이 API에서도 호출 가능합니다.

‍

Q. API는 Play와 어떻게 연결되나요?

A. Play와 API는 동일한 계정, 크레딧, 보이스 라이브러리를 공유합니다.

‍

Q. 크레딧은 API에서만 차감되나요?

A. 아니요. Play와 API는 동일한 크레딧을 공유하므로 어느 쪽에서든 사용 시 차감됩니다.

‍

‍

3. 기본적인 문제 해결

‍

Q. API Key가 유효하지 않다고 나와요

A. 입력한 Key가 정확한지 확인해 주세요. 만료되었거나 삭제된 경우 콘솔에서 재발급이 필요합니다.

‍

Q. 크레딧이 부족하다고 나와요

A. Play에서 플랜을 업그레이드하거나 크레딧을 추가로 충전해 주세요.

‍

Q. 음성이 생성되지 않아요

A. language, style, model 등의 파라미터가 정확히 입력되었는지 확인해 주세요. 오류가 지속된다면 공식 문서 > 오류 지원을 참고해 주세요.

‍

Q. 보다 상세한 기술 오류 정보는 어디서 볼 수 있나요?

A. 공식 문서(link) > 오류 지원 페이지에서 확인하실 수 있습니다.

‍

‍

View All Latest

< <