자주 묻는 질문 (FAQ) - Supertone API Documentation

현재 정식 API 버전/v1/...)이 2025년 5월 28일자로 배포 완료되었으며, 신규 연동 시에는 더 이상 샌드박스 엔드포인트를 사용하지 마시고 /v1버전을 연동해 주세요.

이미 샌드박스에 연동해 사용 중이라면:
2025년 6월 6일 이전까지 /sandbox/... → /v1/...으로 URL만 수정하시면 됩니다.

샌드박스를 연동해 사용한 적이 없다면:
이 문서는 건너뛰고, 정식 버전 문서만 참고하셔도 충분합니다.

📄 정식 문서 보러가기: API 레퍼런스

기존에 사용하던 voice_id가 더 이상 동작하지 않아요.

style 파라미터는 꼭 입력해야 하나요?

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

네, 이제부터 가능합니다.
Play에서 생성한 클론 보이스(예: ‘My Voice 1’)도 샌드박스 및 정식 API에서 호출할 수 있습니다.

보이스 ID를 찾는 방법:

GET /sandbox/voices/search?name=My Voice

기존에 쓰던 API Key를 그대로 사용할 수 있나요?

✅ 대부분의 사용자는 그대로 사용 가능합니다.

⚠️ 단, 다음 조건에 해당하는 엔터프라이즈 고객은 반드시 조치가 필요합니다.

조건	조치
콘솔 가입 없이, 텍스트 파일 등으로 받은 레거시 API Key를 사용 중인 경우	반드시 콘솔에 새로 가입 후 API Key 재발급 필요
콘솔에 가입되어 있으나, 커스텀 보이스 설정 등이 누락된 경우	수퍼톤과 별도 협의 필요 (보이스 권한 이전 등)

샌드박스에서 TTS API 호출 시 크레딧이 차감되나요?

예전처럼 후불 결제를 쓸 수는 없나요?

클론 보이스나 커스텀 보이스의 ID는 어떻게 알 수 있나요?

style이나 language 파라미터를 잘못 입력하면 어떻게 되나요?

샌드박스는 언제까지 사용할 수 있나요?

샌드박스 → v1으로 다시 되돌릴 때는 무엇을 바꿔야 하나요?