API를 처음 사용하는 분부터, 클론드 보이스까지 연동한 사용자까지 가장 자주 묻는 질문들을 주제별로 정리했습니다.

​
1. API 시작하기

콘솔에서 서비스에 가입하면 즉시 발급받을 수 있습니다. 계정당 최대 3개의 Key를 사용할 수 있으며, 유출 시 폐기 및 재발급이 가능합니다.
HTTP 요청 시, x-sup-api-key 헤더에 발급받은 Key를 넣으면 됩니다. 자세한 연동 방법은 빠르게 시작하기를 참고해 주세요.
아니요. Play와 API는 동일한 계정 기반으로 운영됩니다.

​
2. 보이스 & 호출 관련

보이스 ID는 아래 세 가지 방법으로 확인하실 수 있습니다.
  1. Supertone Play 내 보이스 라이브러리에서 복사
  2. GET /v1/voices 엔드포인트를 호출해 전제 조회
  3. GET /v1/voices/search 엔드포인트를 호출해 조건 검색
더 자세한 내용은 보이스 선택 가이드를 확인해주세요.
네. Play에서 생성한 클론드 보이스는 동일 계정으로 API에서도 호출할 수 있습니다. 클론드 보이스 생성은 Play에서만 가능합니다.
GET /v1/voices/search?name=My Voice 로 검색하면, 계정 내에서 생성된 클론드 보이스만 필터링해서 확인할 수 있습니다.더 자세한 내용은 보이스 선택 가이드를 확인해주세요.
아니요. voice_id 외에도 language, style, model 조합이 정확히 일치해야 음성이 정상 생성됩니다.
samples 필드를 통해 보이스별 지원 언어/스타일/모델 조합과 샘플 오디오를 확인할 수 있습니다.더 자세한 내용은 보이스 선택 가이드를 확인해주세요.
아니요. style은 선택 항목이며, 미입력 시 시스템의 기본 스타일이 자동 적용됩니다.
voice_settings를 통해 pitch_shift, pitch_variance, speed를 조정할 수 있습니다.
입력한 텍스트의 발화 길이를 예측해주는 기능입니다. 크레딧이 차감되지 않습니다.

​
3. 크레딧 & 요금제

Play와 동일한 크레딧 시스템을 사용합니다. Play 구독 페이지에서 이용 가능한 플랜을 확인해주세요.
아래 두 가지 방법으로 확인 가능합니다.
  • GET /v1/credits API 호출
  • 콘솔 또는 Play의 대시보드 확인
아니요. Play와 API는 동일한 크레딧을 공유합니다.
네. 같은 계정 내에서 생성한 클론드 보이스는 별도 설정 없이 API에서 호출 가능합니다.

​
4. 오류 및 트러블슈팅

  • 401: API Key 오류
  • 402: 크레딧 부족
  • 403: 권한 없는 보이스 호출
  • 400: 파라미터 오류, 텍스트 초과 등
  • 429: 호출 제한 초과
더 자세한 내용은 오류 처리 가이드를 확인해주세요.
오류 처리 가이드에서 확인하실 수 있습니다.
오류 처리 가이드를 참고해, 아래 내용을 확인해주세요.
  • 헤더에 x-sup-api-key가 포함되었는지 확인
  • Content-Type: application/json 누락 여부 확인
  • voice_id가 실제 값으로 대체되었는지 확인
계속 문제가 발생한다면, 고객 지원 페이지를 통해 문의해주세요.
기본적으로 분당 20회 이하의 호출을 권장합니다. 더 높은 트래픽이 필요한 경우 별도 문의가 필요합니다.
🏢 엔터프라이즈 문의하기

​
5. 운영 정책 및 지원

네. 콘솔 가입 후 크레딧을 충전하면 바로 사용할 수 있으며, 별도 승인은 필요하지 않습니다.
네. 팀 단위 사용, 사용자 계정 분리, 호출 한도 확장 등 별도 조건이 필요한 경우 support를 통해 문의해 주세요.
🏢 엔터프라이즈 문의하기
고객 지원 페이지를 통해 1:1 문의를 남겨주시면 빠르게 답변드리겠습니다.