声音克隆技能 (Voice Clone)

使用 WaveSpeed AI 的 MiniMax Voice Clone 服务进行声音克隆和语音合成。

When to Use

适用于以下场景：

• 需要克隆特定人物的声音
• 使用克隆声音生成口播内容
• 创建个性化的语音助手
• 批量生成配音内容
• 与 STT 结合实现语音交互

Do NOT use this skill if:

• 音频样本质量差（有噪音、背景音乐、多人声）
• 样本时长不在 5-20 秒范围内
• 需要实时语音合成（有一定延迟）
• 涉及版权或隐私问题的声音克隆
• 需要极高精度的情感控制（当前 API 不直接支持）

触发关键词 / Trigger Phrases:

• 语音克隆 / voice cloning
• 声音克隆 / voice clone
• AI语音合成 / AI voice synthesis
• 克隆声音 / clone voice
• 语音生成 / voice generation
• 生成语音 / generate speech
• 文字转语音 / text to speech
• MiniMax声音 / MiniMax voice

Workflow

1. 克隆声音（首次使用）

def clone_voice(audio_path, voice_id, text="我是克隆的声音，很高兴为你服务。"):
    """
    克隆声音并创建 voice_id
    
    Args:
        audio_path: 音频样本路径（MP3/WAV，5-20秒）
        voice_id: 自定义声音ID（如 "wuna-001"）
        text: 测试文本
    
    Returns:
        request_id: 任务ID，用于查询结果
    """
    import requests
    import base64
    
    WAVESPEED_KEY = "your_api_key"
    BASE_URL = "https://api.wavespeed.ai/api/v3"
    HEADERS = {"Authorization": f"Bearer {WAVESPEED_KEY}"}
    JSON_HEADERS = {**HEADERS, "Content-Type": "application/json"}
    
    # 读取音频并转为 base64
    with open(audio_path, 'rb') as f:
        audio_base64 = base64.b64encode(f.read()).decode('utf-8')
    
    url = f"{BASE_URL}/minimax/voice-clone"
    payload = {
        "model": "speech-02-hd",
        "custom_voice_id": voice_id,
        "text": text,
        "audio": audio_base64,
        "need_noise_reduction": False,
        "need_volume_normalization": False,
        "accuracy": 0.8
    }
    
    response = requests.post(url, json=payload, headers=JSON_HEADERS)
    result = response.json()
    
    if response.status_code == 200:
        return result['data']['id']
    else:
        raise Exception(f"克隆失败: {result}")

2. 使用克隆的声音生成语音

def generate_speech(text, voice_id, model="speech-02-hd"):
    """
    使用克隆的声音生成语音
    
    Args:
        text: 要生成的文本
        voice_id: 克隆的声音ID
        model: 语音合成模型
    
    Returns:
        audio_url: 生成的音频URL
    """
    url = f"{BASE_URL}/minimax/{model}"
    payload = {
        "text": text,
        "voice_id": voice_id,
        "language": "zh-CN"
    }
    
    response = requests.post(url, json=payload, headers=JSON_HEADERS)
    result = response.json()
    
    if response.status_code == 200:
        return result['data']['id'], result['data']['urls']['get']
    else:
        raise Exception(f"生成失败: {result}")

3. 查询任务结果

def poll_result(request_id, timeout=60):
    """
    轮询任务结果
    
    Args:
        request_id: 任务ID
        timeout: 最大等待时间（秒）
    
    Returns:
        audio_url: 音频下载URL
    """
    import time
    
    url = f"{BASE_URL}/predictions/{request_id}/result"
    start_time = time.time()
    
    while time.time() - start_time < timeout:
        response = requests.get(url, headers=HEADERS)
        result = response.json()
        
        status = result.get('data', {}).get('status')
        
        if status == 'completed':
            outputs = result.get('data', {}).get('outputs', [])
            return outputs[0] if outputs else None
        elif status == 'failed':
            raise Exception(f"任务失败: {result}")
        
        time.sleep(3)
    
    raise TimeoutError("任务超时")

4. 完整使用示例

# 配置
AUDIO_SAMPLE = "/path/to/sample.mp3"
VOICE_ID = "wuna-001"
KOUBO_TEXT = """我是外企面试官。2026年求职，你一定要学会用人工智能！
不懂人工智能的简历直接被淘汰，会用的轻松拿下高薪offer！"""

# 步骤1：克隆声音（仅需执行一次）
print("步骤1: 克隆声音...")
clone_request_id = clone_voice(AUDIO_SAMPLE, VOICE_ID)
print(f"克隆任务已提交: {clone_request_id}")

# 等待克隆完成
time.sleep(5)

# 步骤2：使用克隆的声音生成语音
print("\n步骤2: 生成语音...")
tts_request_id, result_url = generate_speech(KOUBO_TEXT, VOICE_ID)
print(f"TTS任务已提交: {tts_request_id}")

# 步骤3：获取结果
print("\n步骤3: 等待结果...")
audio_url = poll_result(tts_request_id)
print(f"音频URL: {audio_url}")

Supported Models

声音克隆

• 端点: POST /api/v3/minimax/voice-clone
• 定价: $0.5/次

语音合成

Guardrails

音频样本要求

• 格式: MP3、WAV
• 时长: 5-20秒最佳
• 大小: 建议不超过 1MB
• 质量要求:

- 清晰、无杂音 - 无背景音乐 - 单人声 - 正常语速，避免喊叫或耳语

已配置的声音

最佳实践

1. 音频样本质量: 高质量的 10 秒样本比低质量的 1 分钟样本效果更好
2. 唯一 Voice ID: 使用有意义的命名（如 wuna-001、zhangsan-voice）
3. 及时使用: 创建 voice_id 后立即测试生成一次，避免过期
4. 批量生成: 先测试单条，效果满意后再批量
5. 备份音频: 保存好原始音频样本，voice_id 过期后可重新克隆

常见问题

Project Scripts

Related Skills

About UniqueClub

Part of UniqueClub toolkit - AI-powered creative tools for voice synthesis and cloning. Learn more: https://uniqueclub.ai

最后更新：2026-02-13 验证状态：✅ 吴娜声音克隆测试通过