生成 Persona

基于已生成的音乐创建个性化的音乐 Persona，为音乐赋予独特的身份和特征。

使用指南

此接口用于为已生成的音乐创建 Persona（音乐角色）

需要提供来自音乐生成相关接口（生成、扩展、翻唱、上传扩展）的 taskId 和音频 ID

可以自定义 Persona 的名称和描述，为音乐赋予独特的个性

生成的 Persona 可用于后续的音乐创作和风格迁移

参数详情

参数名	类型	是否必需	说明
`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 的音乐特征、风格和个性

开发者注意事项

重要提示

调用此接口前请确保音乐生成任务已完全完成。如果音乐正在生成中时调用此接口将会返回失败。

模型要求：Persona 生成仅支持使用 v3_5 以上版本 模型生成的音乐的 taskId（v3_5 本身不支持）。

建议为 Persona 提供详细的描述，以便更好地捕捉音乐特征。

返回的 personaId 可以用于后续的音乐生成请求中，以创作具有相似风格特征的音乐。

你可以将 personaId 应用到以下接口：

每个音频 ID 只能生成一次 Persona。

参数示例

{
  "taskId": "5c79****be8e",
  "audioId": "e231****-****-****-****-****8cadc7dc",
  "name": "电子流行歌手",
  "description": "具有现代电子音乐风格的流行歌手，擅长动感节奏和合成器音色"
}

NOTE

确保使用的 taskId 对应的音乐生成任务已完成，且 audioId 在有效范围内。

TIP

为 Persona 提供详细而具体的描述可以帮助系统更准确地捕捉音乐风格特征。

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

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": "5c79****be8e", "audioId": "e231****-****-****-****-****8cadc7dc", "name": "电子流行歌手", "description": "具有现代电子音乐风格的流行歌手，擅长动感节奏和合成器音色" }'

{ "code": 200, "msg": "success", "data": { "personaId": "a1b2****c3d4", "name": "电子流行歌手", "description": "具有现代电子音乐风格的流行歌手，擅长动感节奏和合成器音色" } }

使用指南

参数详情

开发者注意事项

参数示例

Request

Responses

生成 Persona

使用指南#

参数详情#

开发者注意事项#

参数示例#

Request

Responses

使用指南

参数详情

开发者注意事项

参数示例