Skip to main content
POST
카탈로그 음성 또는 본인 소유의 맞춤 더빙 음성 하나에 대한 메타데이터와 재생 가능한 예제를 조회합니다.

인증 및 권한

string
필수
이 헤더에 VoiceCheap API 키를 전달하세요. 동일한 API 키를 사용하는 Authorization: Bearer도 지원합니다. OAuth 액세스 토큰은 MCP에서만 허용되며, 이 REST 엔드포인트에서는 사용할 수 없습니다.
필요한 권한: voices:read. 활성 유료 구독이 필요합니다. 권한은 팀 역할, 리소스 소유권, 미디어 크레딧 또는 요금제 한도를 변경하지 않습니다.

매개변수

string
필수
텍스트 값입니다.최소 길이: 1. 최대 길이: 255. 패턴: ^[A-Za-z0-9_-]+$.
string
텍스트 값입니다.허용값: “en”, “fr”, “es”, “de”, “it”, “pt”, “pl”, “zh”, “ja”. 기본값: “en”.
아래 JSON Schema는 검색을 통해 제공되는 정확한 필드 이름, 중첩 유형, 기본값, 범위 및 허용값을 유지합니다. 추가적인 필드 간 규칙은 작업 참고 사항에 나와 있습니다.

요청 예제

예제의 리소스 식별자와 미디어 키를 계정에서 반환된 값으로 바꾸세요. 동일한 변경 작업을 재시도할 때는 요청 식별자를 유지하세요.

응답

성공한 첫 실행은 작업 결과를 data 아래에 포함하여 HTTP 200을 반환합니다. 재전송 시에는 저장된 요청 상태를 대신 반환할 수 있습니다. 예제는 지원되는 응답 중 하나를 보여주며 모든 선택 필드를 포함하지는 않습니다. 공개 메타데이터와 선택 사항인 재생 가능한 예시가 포함된 카탈로그 음성 또는 소유한 사용자 지정 더빙 음성 하나입니다.

결과 필드

작업 참고 사항

  • dubbing_voices_list의 voiceId를 사용하세요. 이 값은 문자, 숫자, 밑줄 및 하이픈만 포함하는 1–255자의 불투명 ID입니다.
  • locale은 dubbing_voices_list와 기본값 및 허용 값이 동일합니다. 카탈로그 음성에는 현지화된 language, accent, description, age, gender, useCase 및 category 메타데이터가 포함될 수 있습니다.
  • 소유한 사용자 지정 음성은 source: custom과 선택적 previewUrl을 반환하며, 카탈로그 언어 필드는 생략합니다. 원시 복제 응답의 audioExampleUrl은 여기에서 previewUrl로 표시됩니다.
  • 음성 합성 기록과 사용자 지정 음성은 인증된 계정에 속합니다. 팀 결제를 사용해도 다른 멤버의 음성 합성 결과나 음성에 접근할 수 없습니다.

사용량

성공한 호출마다 월간 API/MCP 호출 1회가 차감됩니다. 미디어 크레딧과 해당 작업의 생성 허용량도 적용됩니다.

오류