레거시음성

보이스 디자인

Deprecated

텍스트 프롬프트로 음성을 생성합니다.

헤더

xi-api-keystring선택 사항

쿼리 매개변수

output_formatenum선택 사항

생성된 오디오의 출력 형식입니다.

요청

This endpoint expects an object.
voice_descriptionstring필수20-1000 characters

생성된 음성에 사용할 설명입니다.

textstring or null선택 사항100-1000 characters

생성할 텍스트입니다. 텍스트 길이는 100자에서 1000자 사이여야 합니다.

auto_generate_textboolean선택 사항기본값 false

음성 설명에 적합한 텍스트를 자동으로 생성할지 여부입니다.

loudnessdouble선택 사항-1-1기본값 0.5

생성된 음성의 볼륨 레벨을 제어합니다. -1은 가장 작고, 1은 가장 크며, 0은 약 -24 LUFS에 해당합니다.

qualitydouble선택 사항-1-1기본값 0.9

품질이 높을수록 음성 출력은 향상되지만 다양성은 줄어듭니다.

seedinteger or null선택 사항0-2147483647

음성 생성을 제어하는 난수입니다. 동일한 입력에 동일한 시드를 사용하면 동일한 음성이 생성됩니다.

guidance_scaledouble선택 사항0-100기본값 5

AI가 프롬프트를 얼마나 엄격하게 따를지 제어합니다. 값이 낮을수록 AI가 창의성을 발휘할 여지가 커지고, 값이 높을수록 프롬프트를 더 엄격하게 따릅니다. 값이 높으면 음성이 부자연스럽거나 로봇처럼 들릴 수 있습니다. Guidance Scale이 낮을 때는 더 길고 자세한 프롬프트를 사용하는 것이 좋습니다.

should_enhanceboolean선택 사항기본값 false

AI를 사용해 음성 설명에 더 많은 세부 정보를 추가하고 음성 생성 품질을 개선할지 여부입니다. 활성화하면 시스템이 간단한 프롬프트를 더 상세한 음성 설명으로 자동 확장합니다. 기본값은 False입니다.

응답

성공 응답

previewslist of objects

생성된 음성의 미리보기입니다.

textstring

음성을 미리 듣는 데 사용되는 텍스트입니다.

오류

409
Conflict Error
422
Unprocessable Entity Error