자주 묻는 질문
API 사용 중 자주 받는 질문과 그에 대한 답변을 정리했습니다.
API를 처음 사용하는 분부터, 클론드 보이스까지 연동한 사용자까지 가장 자주 묻는 질문들을 주제별로 정리했습니다.
1. API 시작하기
콘솔에서 서비스에 가입하면 즉시 발급받을 수 있습니다. 계정당 최대 3개의 Key를 사용할 수 있으며, 유출 시 폐기 및 재발급이 가능합니다.
HTTP 요청 시, x-sup-api-key 헤더에 발급받은 Key를 넣으면 됩니다. 자세한 연동 방법은 빠르게 시작하기를 참고해 주세요.
아니요. Play와 API는 동일한 계정 기반으로 운영됩니다.
2. 보이스 & 호출 관련
보이스 ID는 아래 세 가지 방법으로 확인하실 수 있습니다.
- Supertone Play 내 보이스 라이브러리에서 복사
- GET /v1/voices 엔드포인트를 호출해 전제 조회
- 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/creditsAPI 호출- 콘솔 또는 Play의 대시보드 확인
아니요. Play와 API는 동일한 크레딧을 공유합니다.
네. 같은 계정 내에서 생성한 클론드 보이스는 별도 설정 없이 API에서 호출 가능합니다.
4. 오류 및 트러블슈팅
- 401: API Key 오류
- 402: 크레딧 부족
- 403: 권한 없는 보이스 호출
- 400: 파라미터 오류, 텍스트 초과 등
- 429: 호출 제한 초과
더 자세한 내용은 오류 처리 가이드를 확인해주세요.
오류 처리 가이드에서 확인하실 수 있습니다.
5. 운영 정책 및 지원
네. 콘솔 가입 후 크레딧을 충전하면 바로 사용할 수 있으며, 별도 승인은 필요하지 않습니다.
네. 팀 단위 사용, 사용자 계정 분리, 호출 한도 확장 등 별도 조건이 필요한 경우 support를 통해 문의해 주세요.
고객 지원 페이지를 통해 1:1 문의를 남겨주시면 빠르게 답변드리겠습니다.