音乐生成 · 创建歌手风格

基于已生成歌曲创建可复用的歌手风格 ID。

基本信息

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

鉴权

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

业务参数

参数类型必填默认值可选值 / 范围示例说明
audio_idstring是--audio_xxxxxxxxxxxx音频 ID,用于定位已生成或已上传的音频片段。
namestring是--My Singer Style歌手风格名称。
descriptionstring否---歌手风格的文字描述。
vocal_startnumber否---人声片段开始时间,单位秒。
vocal_endnumber否---人声片段结束时间,单位秒。
vox_audio_idstring否---用于创建新歌手风格的人声参考音频 ID。

响应说明

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

成功示例

{
    "code": 1,
    "msg": "success",
    "data": {
        "result": {
            "status": "completed",
            "persona_id": "persona_xxxxxxxxxxxx",
            "data": {
                "persona_id": "persona_xxxxxxxxxxxx"
            }
        },
        "usage": {
            "points_cost": 12,
            "actual_points": 12
        }
    }
}

失败示例

{
    "code": 0,
    "msg": "任务处理失败,请稍后重试",
    "data": null
}

同类文章