요청 중 발생할 수 있는 오류 유형과 그에 대한 원인 및 해결 방법을 안내합니다.
text
, language
등 필수 필드를 누락한 경우style
또는 model
값에 존재하지 않는 값을 입력한 경우voice_settings
의 파라미터 값이 허용 범위를 벗어난 경우 (예: pitch_shift: 20)요청 바디를 다시 한번 확인해 주세요. 에디터나 Linter를 사용해 JSON 구조를 검증하는 것도 좋습니다.
x-sup-api-key
헤더가 없는 경우콘솔에서 발급받은 API Key를 정확히 입력했는지 확인해 주세요. 문자열 복사 시 앞뒤 공백이 포함되지 않도록 주의해야 합니다.
Play 구독 페이지에서 플랜을 결제하거나, 크레딧을 충전한 뒤 다시 시도하세요.
클론드 보이스를 호출할 때도 동일하게 크레딧이 차감됩니다.
voice_id
가 내 계정 소유가 아닐 경우 (예: 다른 사용자의 클론 보이스)GET /v1/voices를 호출해 해당 보이스의 이용권한 여부를 다시 확인해 보세요.
클론드 보이스는 만든 계정으로만 호출할 수 있습니다.
계정이 다를 경우 403이 발생합니다.
voice_id
를 사용했을 경우GET /voices/search
에서 너무 좁은 조건으로 필터링해 결과가 0건일 때요청 경로와 파라미터 값이 정확한지 다시 확인해 주세요.
voice_id
는 콘솔 또는GET /voices
로 확인 가능합니다.
동일한 요청이 반복적으로 Timeout되는 경우 고객 지원을 통해 문의해 주세요.
요청을 단순화하거나, 입력값을 줄여 다시 시도해볼 수 있습니다.
잠시 기다린 후 다시 요청을 보내주세요.
엔터프라이즈 사용자의 경우, 요청 제한 상향 조정이 가능합니다. (엔터프라이즈 문의하기)
동일한 요청이 반복적으로 실패한다면, 요청 바디를 포함하여 고객 지원을 통해 문의해 주세요.
발생 시점을 로그로 남겨두는 것이 문제 해결에 도움이 됩니다.