[안내] Supertone API는 2026년 8월 31일 서비스를 종료합니다. 2026년 7월 23일부로 신규 가입·결제가 중단되었습니다. Enterprise 계약 고객은 담당 매니저가 개별 안내드립니다. 자세한 내용: supertone.ai
1. API 시작하기
Q. API Key는 어디서 발급받나요?
A. 기존 계정의 API Key는 API 콘솔에서 관리할 수 있습니다. 신규 가입 및 Key 발급은 2026년 7월 23일부로 중단되었습니다. 한 계정당 최대 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. language, style, model 등의 파라미터가 정확히 입력되었는지 확인해 주세요. 오류가 지속된다면 공식 문서 > 오류 지원을 참고해 주세요.
Q. 보다 상세한 기술 오류 정보는 어디서 볼 수 있나요?
A. 공식 문서 > 오류 지원 페이지에서 확인하실 수 있습니다.
Q. 위 방법으로도 해결되지 않으면 어떻게 하나요?
A. 1:1 문의하기를 통해 자세한 상황을 보내주시면 빠르게 도와드리겠습니다.