生成 Persona
POST
/api/v1/generate/generate-persona
基于已生成的音乐创建个性化的音乐 Persona，为音乐赋予独特的身份和特征。
使用指南
taskId 和音频 ID参数详情
| 参数名 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
taskId | string | 必需 | 指定原始音乐生成任务的唯一标识符。可以是以下接口返回的 taskId：• 生成音乐 ( /api/v1/generate)• 扩展音乐 ( /api/v1/generate/extend)• 上传并翻唱音频 ( /api/v1/generate/upload-cover)• 上传并扩展音频 ( /api/v1/generate/upload-extend) |
audioId | string | 必需 | 指定要创建 Persona 的音频 ID |
name | string | 必需 | 为 Persona 指定一个易于识别的名称 |
description | string | 必需 | 描述 Persona 的音乐特征、风格和个性 |
开发者注意事项
重要提示
taskId（v3_5 本身不支持）。personaId 可以用于后续的音乐生成请求中，以创作具有相似风格特征的音乐。参数示例
{
"taskId": "5c79****be8e",
"audioId": "e231****-****-****-****-****8cadc7dc",
"name": "电子流行歌手",
"description": "具有现代电子音乐风格的流行歌手，擅长动感节奏和合成器音色"
}taskId 对应的音乐生成任务已完成，且 audioId 在有效范围内。Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kie.ai/api/v1/generate/generate-persona' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"taskId": "2fac****9f72",
"audioId": "e231****-****-****-****-****8cadc7dc",
"prompt": "A calm and relaxing piano track.",
"tags": "Jazz",
"title": "Relaxing Piano",
"negativeTags": "Rock",
"infillStartS": 10.5,
"infillEndS": 20.75,
"fullLyrics": "[Verse 1]\nOriginal lyrics here\n[Chorus]\nModified lyrics for this section\n[Verse 2]\nMore original lyrics",
"callBackUrl": "https://example.com/callback"
}'Response Response Example
{
"code": 200,
"msg": "success",
"data": {
"personaId": "a1b2****c3d4",
"name": "电子流行歌手",
"description": "具有现代电子音乐风格的流行歌手，擅长动感节奏和合成器音色"
}
}