教程指南
排查 CosyVoice 3 Flash 的音色情绪支持、指令语言和地域配置，区分国际部署、音色可用性与 APIXO 调用。
CosyVoice 3 Flash 的情绪指令没有产生预期效果，先检查当前音色是否支持 Instruct，再看文本语言、指令格式和服务配置。接口接收了 instruction，不意味着所选音色一定会执行它。对于跨地区使用者，还要区分用户所在国家与提供服务的部署地域。
官方音色列表按音色列出语言、Instruct、SSML 与时间戳支持。先定位 cosyvoice-v3-flash 下的 voice 标识，再查看该行的能力，不要用其他模型或同名音色的说明代替。
例如 longanyang 支持 Instruct，官方提供固定格式；longanlang_v3 虽然支持语音合成，却在当前音色表中标记为不支持 Instruct。两者都能生成声音，不代表都能用同样的情绪指令。音色表于 2026 年 10 月 8 日更新，使用前仍应核对。
先用两句短文本做无指令基线，再只增加一个已支持的情绪。下面是排查方法，不是已验证的修复率。
官方 longanyang 的格式行使用中文句号，示例行使用英文句点。下方请求依据格式行写中文句号，尚未在线执行；若你的入口有更明确要求，照该要求测试一个短样本。不要在大批量生成前把这份示例当成稳定配方。
朗读文本必须使用该音色支持的语言。指令语言则可能另有规定：longanyang 的官方说明要求以中文指定指令，即使朗读内容为英文，也不能因此默认把 instruction 改成英文。
使用固定格式的音色时，应复制官方格式并核对标点。不要把“角色设定、广告目的、多个情绪、语言切换”同时塞进第一条测试指令。先只验证一个情绪变化，再扩大内容。
以下为依据官方格式整理、未执行的 APIXO 请求体示例：
{
"request_type": "async",
"input": {
"mode": "speech",
"voice": "longanyang",
"prompt": "Welcome. We are glad you are here.",
"instruction": "你说话的情感是happy。",
"format": "mp3"
}
}示例选择了官方标记支持 Instruct 的音色，不适用于每一个 voice；实际情绪效果仍须用短样本试听。 APIXO CosyVoice Docs当前要求 instruction 不超过 100 字符。
SSML 用于支持的停顿、读法或表达控制，Instruct 用于音色支持的指令能力。某个音色支持 SSML，却可能不支持 Instruct。需要两者配合时，先分别确认功能能运行，再组合，避免难以定位问题。
将一段很长的文本缩短为两个句子，先生成没有情绪指令的基线，再添加一条指令。比较同一音色、相同文本，才容易知道差异来自哪里。生成成功但听感没有变化时，不要立即归因于国家限制。
阿里云的“地域”说明主要描述接入点、数据存储位置、服务部署范围及对应模型列表。北京和新加坡各自使用对应的端点与服务配置，不能混用地域资源。 官方地域说明
当前官方表格列出 CosyVoice V3 Flash 的新加坡 International 部署；音色表也列出 longanyang 在北京和新加坡均可用。因此，不能把“某些功能只在北京提供”直接写成“其他国家的用户不能通过 API 使用模型”。本次资料核查没有发现能够支持这一笼统结论的按用户国家全面封禁说明。 官方模型部署表
但具体功能确实有差别：官方当前说明，新加坡的 V3 Flash 不支持使用克隆音色进行合成。这个限制针对该地区该模型的克隆功能，不等于预设音色语音合成不可用，也不能直接套到使用其他服务路由的平台。 官方声音复刻说明
在 APIXO，通过其统一接口和自己的 APIXO 配置提交任务，不需要把阿里云直连端点复制到请求里。当前公开 Docs 列出 speech、clone、design，并允许 speech 使用预设音色或已创建的 voice_id。应按 APIXO 的实际调用约定排查，不能仅凭阿里云新加坡的单项限制推断 APIXO 也使用同一地区或同一路由。
首先确认 voice 是否属于当前模型，文本语言是否匹配，instruction 是否在限制内。使用自定义声音时，检查它是否已经可用并匹配当前用户、提供方与模型。任务失败时记录任务 ID、错误码和参数，避免只保存“没有情绪”的描述。
本文没有做跨国网络实测，也没有核验 APIXO 上游部署地区，因此不承诺所有国家和网络均能访问。遇到明确的权限或访问失败，再根据错误信息判断服务配置、网络或路由问题。
先选官方明确支持 Instruct 的音色；使用其支持的朗读语言；按该音色要求填写一条短指令；对照无指令基线试听。若仍无变化，保留结果与参数检查服务端错误和实际路由。
从 APIXO CosyVoice 文档核对当前字段，费用查看 APIXO Pricing。本文重点是功能排查，不用供应商地区价格替代 APIXO 费用。
这里是 API 按量费率；Studio 月度订阅积分另计。
使用 APIXO 构建
一站式探索图像、视频和音频模型。