Skip to content
cccskills
FreePublished on GitHub

voice-clone

Create a custom voice from an authorized speech sample, then synthesize scripts for narration, spoken presentations, or product promotion. Cloud providers generate mp3 or wav audio using supplied credentials, without requiring a local GPU.

OriginalShow the original description

上传本人语音样本克隆专属音色,再用它合成口播、旁白或带货语音。当用户说“声音克隆、克隆/复刻我的声音、用我的声音配音、定制专属音色”时使用,需要用户自备云端 provider 凭证。使用公共现成音色时改用 tts-voiceover。

Works withOpenAIGemini
See how to install

Good for

  • Generate channel introductions in your own voice
  • Produce narration from a script
  • Create product promotion audio with an authorized voice
  • Register a voice for later speech synthesis

Files included (1)

  • SKILL.md4.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

声音克隆配音

用本人语音样本克隆音色,再合成任意文案。走云端 provider(用户自备 key),本地无需 GPU。 全部走 skills/shared/scripts/voice_clone.py。

不想克隆、用现成公共音色见 tts-voiceover(edge-tts,免费无需 key); AI 生成音乐/BGM 见 ai-music;合成后与 BGM 混音见 audio-mix。

前置:配置 API key

配置检查路径铁律:先 cd 到运行时说明给出的 Easel 项目根,确认当前目录有 .env 和 skills/shared/scripts/,再运行注册表、check、enroll 或 clone。不得改用 workspace 的共享脚本副本,也不得以 env / printenv 没显示变量为由判断 VOICE_BASE_URL/Key 缺失。check 支持时显式传 --env-file .env。

选 provider 并在 .env 填 key,再 check 离线校验:

python skills/shared/scripts/voice_clone.py check --provider minimax --env-file .env
provider服务.env 需配
dashscope阿里 CosyVoice 声音复刻DASHSCOPE_API_KEY(可选 DASHSCOPE_TTS_MODEL/DASHSCOPE_BASE_URL)
minimaxMiniMax 语音克隆MINIMAX_API_KEY、MINIMAX_GROUP_ID(可选 MINIMAX_MODEL)
fish-audioFish AudioFISH_API_KEY(可选 FISH_BASE_URL)
openai-compatibleOpenAI 兼容 /audio/speechVOICE_API_KEY、VOICE_BASE_URL(预置 voice,非零样本克隆)
geminiGoogle Gemini TTSGEMINI_API_KEY(可选 GEMINI_TTS_MODEL/GEMINI_VOICE/GEMINI_BASE_URL)

⚠️ 各 provider 依公开 API 文档实现,端点/模型名可用 env 覆盖以适配实际参数。

执行前先跑 model_registry.py configured --group voice --env-file .env。只有一个可用时显式选择;多个可用且用户没点名时,列出 provider/模型询问本次使用哪个,不按 VOICE_PROVIDER 擅自选择。

输入

字段必填说明
语音样本克隆时必填本人清晰无噪的语音(一般 10s-1min,具体看 provider 要求)
文案合成时必填要用克隆音色说出来的文字

输出(outputs/主题名/)

  • 合成的语音音频(mp3/wav)

执行步骤

脚本路径(相对项目根):skills/shared/scripts/voice_clone.py(各子命令支持 -h)。

1. 登记音色(enroll,得到 voice_id)

# minimax:上传样本文件
python skills/shared/scripts/voice_clone.py enroll --provider minimax \
  --sample me.mp3 --name my_voice
# dashscope:用公网可访问的样本 URL
python skills/shared/scripts/voice_clone.py enroll --provider dashscope \
  --sample-url https://.../me.wav --name myv

(fish-audio 用已有 model_id 或内联参考音频,openai-compatible 用预置 voice 名,无需 enroll。)

2. 合成(clone)

python skills/shared/scripts/voice_clone.py clone --provider minimax \
  --voice-id my_voice --text "大家好,欢迎来到我的频道" --speed 1.0 \
  -o outputs/主题名/vo.mp3

fish-audio 也可直接给参考音频:--sample ref.mp3 --sample-text "参考音频的文字"。

合规红线(必须遵守)

  1. 只能克隆你有权使用的声音(本人,或已获明确授权的人)。
  2. 不得克隆他人/名人声音用于误导、诈骗、冒充、伪造。
  3. 合成内容不得用于虚假信息或侵权用途。 —— 越线不做,并向用户说明。

规则

  1. 样本质量决定克隆效果:清晰、无背景噪、语气自然、时长足够。
  2. 先 check 确认 key,再 enroll,再 clone。
  3. 合成语音可接 audio-mix 加 BGM、接 auto-subtitle 出字幕、接视频。
  4. 产物统一进 outputs/主题名/。

参考来源

主流声音克隆云服务:阿里 CosyVoice(声音复刻)、MiniMax(语音克隆 + T2A)、Fish Audio、 OpenAI 兼容 TTS。本地零样本克隆(GPT-SoVITS/CosyVoice 本地)需 GPU,故走云端 provider。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ai-image-gen

FreeSummary

Generate images from written descriptions, transform existing images with editing instructions, or create several variations. Choose image dimensions and quantity, then save the results using an OpenAI-compatible service or apimart with your own API key.

  • Generating an illustration from a written description
  • Changing an image's background using instructions
  • Creating several variations of an existing image
ZJU-REAL/Easel4KUpdated Oct 21, 2026

ai-music

FreeSummary

Generate background music for short videos, vlogs, and social posts from descriptions of mood, style, and instruments. Download MP3 audio, optionally include sung lyrics, and use shared scripts to trim tracks, adjust loudness, or add music to videos.

  • Generating background music for a vlog intro
  • Creating instrumental music to match a social post
  • Generating a sung track from supplied lyrics
ZJU-REAL/Easel4KUpdated Oct 21, 2026

ai-video-gen

FreeSummary

Create new videos from written scene descriptions or still images using external AI services. Set the aspect ratio and duration, animate a character image, and request generated audio when the selected model supports it.

  • Generate a short video from a scene description
  • Animate a still image
  • Create character motion from a starting image
ZJU-REAL/Easel4KUpdated Oct 21, 2026

asset-manager

FreeSummary

Organize generated images, videos, and text in outputs/ by date, platform, and type. Add tags, search filenames and content, produce asset lists and reports, and preview archive moves before applying them to make past work easier to reuse.

  • Organizing generated assets by date, platform, and type
  • Finding past content through keywords and tags
  • Listing assets for a specific account or platform
ZJU-REAL/Easel4KUpdated Oct 21, 2026

audio-denoise

FreeSummary

Reduce background noise in audio recordings or video soundtracks with three processing levels. Keep the original file, create a cleaned version, and receive a report of the settings used and file details before and after processing.

  • Reducing fan or air conditioner noise in recordings
  • Cleaning speech in podcasts and interviews
  • Reducing noise in a video's audio track
ZJU-REAL/Easel4KUpdated Oct 21, 2026

audio-editing

FreeSummary

Edit audio files by trimming sections, converting formats, matching loudness, or extracting sound from videos. You can also join recordings, add fades, and change playback speed while keeping the original pitch.

  • Trim a recording to the section you need
  • Convert audio formats and match loudness
  • Extract audio from a video
ZJU-REAL/Easel4KUpdated Oct 21, 2026

See all skills by ZJU-REAL

Report a problem with this skill