가이드
CosyVoice 3 Flash의 음색, 언어, Instruct와 중국어 지시를 확인하고 서비스 리전과 사용자의 국가를 구분합니다.
CosyVoice 3 Flash의 감정 지시가 기대대로 반영되지 않으면 프롬프트를 바꾸기 전에 선택한 음색이 Instruct를 지원하는지 확인하세요. 그다음 합성할 언어, 지시 형식, 서비스 설정을 점검합니다. instruction 필드가 접수됐다고 모든 음색이 그 지시를 따를 수 있는 것은 아닙니다.
2026년 10월 8일 업데이트된 공식 음색 목록은 음색별 지원 언어, Instruct, SSML, 타임스탬프 기능을 안내합니다.
예를 들어 longanyang은 정해진 형식의 Instruct를 지원하지만, longanlang_v3는 Instruct 미지원으로 표시됩니다. 음성 합성이 가능하다고 감정 제어까지 동일하게 지원하는 것은 아닙니다.
다른 버전의 비슷한 이름을 참고하지 말고, 사용하는 모델과 정확한 음색 ID의 항목을 확인하세요.
먼저 지시 없이 두 문장을 합성한 결과를 비교 기준으로 삼으세요. 음색과 텍스트를 유지한 채 지원되는 감정 지시 하나만 추가합니다. 문제를 좁히는 방법이며 해결률을 측정한 결과는 아닙니다.
longanyang의 공식 형식 설명은 중국어 마침표를 쓰지만 예제는 ASCII 마침표를 사용합니다. 아래 요청은 형식 설명을 따르며 실제 실행하지 않았습니다. 사용하는 경로에 더 구체적인 조건이 있다면 그 조건으로 짧게 테스트한 뒤 일괄 생성하세요. 검증된 운영 예시로 취급하지 마세요.
읽을 텍스트는 음색이 지원하는 언어여야 합니다. 감정 제어 지시는 별도의 언어 조건이 있을 수 있습니다. longanyang 문서는 영어 텍스트를 합성할 때도 중국어 지시를 요구합니다.
제출되지 않은 APIXO 요청 본문 예는 다음과 같습니다.
{
"request_type": "async",
"input": {
"mode": "speech",
"voice": "longanyang",
"prompt": "Welcome. We are glad you are here.",
"instruction": "你说话的情感是happy。",
"format": "mp3"
}
}중국어 제어 문자열은 원문 그대로 유지하세요. 공식 형식 설명은 중국어 마침표를, 예제는 ASCII 마침표를 사용합니다. 위 요청은 미실행 예시이므로 그대로 쓰면 성공한다고 보장하지 않습니다. 음색별 명세를 확인하고 짧은 샘플로 검증하세요.
APIXO CosyVoice Docs의 현재 지시 길이 제한은 100자입니다. 역할, 상황, 언어 지시를 함께 넣기 전에 감정 하나부터 테스트하세요.
SSML을 지원하면서 Instruct는 지원하지 않는 음색도 있습니다. 두 기능을 함께 사용하기 전에 각각의 지원 여부를 확인하세요.
지시 없는 두 문장을 비교 기준으로 삼고 같은 음색과 텍스트에 지시 하나를 추가해 들어보세요. 소리가 달라지지 않았다는 사실만으로 국가 제한을 판단할 수는 없습니다.
Alibaba Cloud의 리전 문서는 접속 지점, 배포, 리소스 설정을 설명합니다. 베이징과 싱가포르 리전에서 사용하려면 각각 적절한 서비스 설정이 필요합니다.
현재 공식 표에는 V3 Flash의 싱가포르 국제 배포가 있으며 longanyang은 베이징과 싱가포르에 모두 표시됩니다. 확인한 문서만으로 중국 외 사용자가 API를 사용할 수 없다고 결론 내릴 수는 없습니다. 그렇다고 모든 계정, 국가, 네트워크에서 제한 없이 접속된다고 보장하는 것도 아닙니다.
기능별 차이는 있습니다. 음성 복제 가이드는 싱가포르 V3 Flash에서 복제 음성 합성을 지원하지 않는다고 명시합니다. 이는 기본 제공 음색의 이용 가능 여부와 별개입니다. 공식 배포 표는 제공사의 자료이며 APIXO 요금표가 아닙니다.
APIXO의 통합 인터페이스와 설정을 사용하세요. 현재 문서는 speech, clone, design을 안내하며 합성에는 기본 제공 음색 또는 생성된 voice_id를 사용합니다. APIXO가 이용하는 상위 서비스의 배포 리전은 확인하지 못했으므로 특정 Alibaba 리전이나 그 제한이 그대로 적용된다고 가정하지 마세요.
음색, 텍스트 언어, 지시 길이, 맞춤 음성의 준비 상태를 확인하세요. 실패하면 작업 ID, 오류 코드, 매개변수를 기록합니다. 이 글에서는 국가 간 API 호출 테스트를 수행하지 않았습니다.
Instruct 지원이 명시된 음색, 지원 언어의 텍스트, 음색별 지시 하나로 시작하세요. 지시 없는 결과와 비교한 뒤 필요하면 설정과 경로를 점검합니다. 플랫폼 비용은 APIXO Pricing을 확인하세요.
API 사용량 요금이며 Studio 월간 크레딧은 별개입니다.
APIXO로 빌드하기
이미지, 동영상, 오디오 모델을 한곳에서 탐색해 보세요.