mcpField
A
alicloud-ai-audio-cosyvoice-voice-clone

alicloud-ai-audio-cosyvoice-voice-clone

github.com/cinience创意与媒体396110 次安装11 周前更新
代码仓库

关于 alicloud-ai-audio-cosyvoice-voice-clone

用于阿里云 Model Studio CosyVoice 的音色注册技能，可从公开参考音频创建克隆音色，并返回后续语音合成所需的音色 ID。

主要功能

  1. 01使用公开音频 URL 注册音色
  2. 02支持多个 CosyVoice 目标模型
  3. 03可指定语言提示
  4. 04返回供合成使用的音色 ID

适用场景

  1. 01为后续语音合成创建克隆音色
  2. 02按目标模型和语言提示注册参考音频

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cinience/alicloud-skills --skill alicloud-ai-audio-cosyvoice-voice-clone

安装后在 Claude Code 中输入/alicloud-ai-audio-cosyvoice-voice-clone确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
evals/
evals.json
references/
api_reference.md
sources.md
scripts/
prepare_cosyvoice_clone_request.py

详细介绍

Category: 提供商

Model Studio CosyVoice 音色克隆

使用 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，或将 dashscope_api_key 添加到 ~/.alibabacloud/credentials。
  • 提供注册样本的公开音频 URL。

标准化接口（cosyvoice.voice_clone）

请求
  • model（字符串，可选）：固定为 voice-enrollment
  • target_model（字符串，可选）：默认值为 cosyvoice-v3.5-plus
  • prefix（字符串，必填）：仅限字母／数字，最多 10 个字符
  • voice_sample_url（字符串，必填）：公开音频 URL
  • language_hints（数组[string]，可选）：仅使用第一项
  • 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 调用中将其用作 voice 参数
  • request_id（字符串）
  • usage.count（数字，可选）

操作指南

  • 对于中文方言参考音频，使用 language_hints=["zh"]；之后在合成过程中通过文本或 instruct 控制方言风格。
  • 对于 cosyvoice-v3.5-plus，支持的 language_hints 包括 zh、en、fr、de、ja、ko、ru、pt、th、id、vi。
  • 避免频繁调用注册接口；每次调用都会创建新的自定义音色并消耗配额。

本地辅助脚本

准备标准化请求 JSON：

python skills/ai/audio/alicloud-ai-audio-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/alicloud-ai-audio-cosyvoice-voice-clone
for f in skills/ai/audio/alicloud-ai-audio-cosyvoice-voice-clone/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-ai-audio-cosyvoice-voice-clone/validate.txt

通过标准：命令以 0 退出，且生成 output/alicloud-ai-audio-cosyvoice-voice-clone/validate.txt。

输出与证据

  • 将产物、命令输出和 API 响应摘要保存到 output/alicloud-ai-audio-cosyvoice-voice-clone/ 下。
  • 在证据文件中包含 target_model、prefix 和样本 URL。

参考资料

  • references/api_reference.md
  • references/sources.md

评论

支持 Markdown