音乐生成 · 创建歌手风格
基于已生成歌曲创建可复用的歌手风格 ID。
基本信息
| 字段 | 内容 |
|---|---|
| 应用编码 | music_generation |
| API 编码 | persona |
| 请求方式 | POST |
| 请求路径 | /api/v1/apps/music_generation/persona |
| 调用模式 | 同步 |
鉴权
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
业务参数
| 参数 | 类型 | 必填 | 默认值 | 可选值 / 范围 | 示例 | 说明 |
|---|---|---|---|---|---|---|
audio_id | string | 是 | - | - | audio_xxxxxxxxxxxx | 音频 ID,用于定位已生成或已上传的音频片段。 |
name | string | 是 | - | - | My Singer Style | 歌手风格名称。 |
description | string | 否 | - | - | - | 歌手风格的文字描述。 |
vocal_start | number | 否 | - | - | - | 人声片段开始时间,单位秒。 |
vocal_end | number | 否 | - | - | - | 人声片段结束时间,单位秒。 |
vox_audio_id | string | 否 | - | - | - | 用于创建新歌手风格的人声参考音频 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
}