by 运行时依赖
安装命令
点击复制技能文档
类别：提供商 Model Studio CosyVoice Voice Clone 使用 CosyVoice 语音注册 API 从公共参考音频创建克隆语音。 关键模型名称 使用 model="voice-enrollment" 和以下 target_model 值之一： cosyvoice-v3.5-plus cosyvoice-v3.5-flash cosyvoice-v3-plus cosyvoice-v3-flash cosyvoice-v2 推荐默认值：target_model="cosyvoice-v3.5-plus" 区域和兼容性 cosyvoice-v3.5-plus 和 cosyvoice-v3.5-flash 仅在中国大陆部署模式（北京端点）中可用。 在国际部署模式（新加坡端点）中，cosyvoice-v3-plus 和 cosyvoice-v3-flash 不支持语音克隆/设计。 注册期间使用的 target_model 必须与后期语音合成中使用的模型匹配，否则合成将失败。 端点 国内：https://dashscope.aliyuncs.com/api/v1/services/audio/tts/customization 国际：https://dashscope-intl.aliyuncs.com/api/v1/services/audio/tts/customization 先决条件 在环境中设置 DASHSCOPE_API_KEY，或在 ~/.alibabacloud/credentials 中添加 dashscope_api_key。 提供公共音频 URL 作为注册样本。 标准化接口（cosyvoice.voice_clone） 请求模型（字符串，可选）：固定为 voice-enrollment target_model（字符串，可选）：默认为 cosyvoice-v3.5-plus 前缀（字符串，必需）：仅限字母/数字，最大 10 个字符 voice_sample_url（字符串，必需）：公共音频 URL language_hints（字符串数组，可选）：仅使用第一个项 max_prompt_audio_length（浮点数，可选）：仅适用于 cosyvoice-v3.5-plus、cosyvoice-v3.5-flash 和 cosyvoice-v3-flash enable_preprocess（布尔值，可选）：仅适用于 cosyvoice-v3.5-plus、cosyvoice-v3.5-flash 和 cosyvoice-v3-flash 响应 voice_id（字符串）：在后续 TTS 调用中使用此值作为语音参数 request_id（字符串） usage.count（数字，可选） 操作指南 对于中文方言参考音频，请保持 language_hints=["zh"]；在合成中通过文本或指令控制方言样式。 对于 cosyvoice-v3.5-plus，支持的 language_hints 包括 zh、en、fr、de、ja、ko、ru、pt、th、id 和 vi。 避免频繁的注册调用；每个调用都会创建一个新自定义语音并消耗配额。 本地帮助脚本 准备标准化请求 JSON： python skills/ai/audio/aliyun-cosyvoice-voice-clone/scripts/prepare_cosyvoice_clone_request.py \ --target-model cosyvoice-v3.5-plus \ --prefix myvoice \ --voice-sample-url https://example.com/voice.wav \ --language-hint zh 验证 mkdir -p output/aliyun-cosyvoice-voice-clone for f in skills/ai/audio/aliyun-cosyvoice-voice-clone/scripts/*.py; do python3 -m py_compile "$f" done echo "py_compile_ok" > output/aliyun-cosyvoice-voice-clone/validate.txt 通过标准： 命令退出 0 且 output/aliyun-cosyvoice-voice-clone/validate.txt 已生成。 输出和证据 将工件、命令输出和 API 响应摘要保存在 output/aliyun-cosyvoice-voice-clone/ 下。 在证据文件中包含 target_model、前缀和样本 URL。 参考 references/api_reference.md references/sources.md