音乐生成 · 声音克隆

基于清晰人声音频创建私有声音风格 ID。

基本信息

字段内容
应用编码music_generation
API 编码voice_clone
请求方式POST
请求路径/api/v1/apps/music_generation/voice_clone
调用模式同步

鉴权

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

业务参数

参数类型必填默认值可选值 / 范围示例说明
audio_urlstring是--https://example.com/voice.mp3可公开访问的 MP3 或 WAV 人声音频 URL。音频至少 10 秒,建议单人清晰人声,尽量避免背景噪音或背景音乐。
namestring否--My Voice自定义声音风格名称。
descriptionstring否---自定义声音风格描述。

响应说明

同步返回处理结果。媒体类结果可能包含 audio_url、video_url、file_url、image_url、audio_id、persona_id 等字段,具体以接口实际结果为准。

成功示例

{
    "code": 1,
    "msg": "success",
    "data": {
        "result": {
            "status": "completed",
            "voice_id": "voice_xxxxxxxxxxxx",
            "data": {
                "voice_id": "voice_xxxxxxxxxxxx",
                "name": "My Voice"
            }
        },
        "usage": {
            "points_cost": 20,
            "actual_points": 20
        }
    }
}

失败示例

{
    "code": 0,
    "msg": "Audio duration must be between 10 and 240 seconds.",
    "data": null
}

同类文章