生成 Persona

文档已更新

若你此前已完成对接，仍可前往旧版文档查看：旧版地址 (https://docs.kie.ai/old-model/cn/suno-api/generate-persona)

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

使用指南

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

需要提供来自音乐生成相关接口（生成、扩展）的 task_id 和音频 ID

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

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

参数详情

参数名	类型	是否必需	说明
`task_id`	`string`	必需	指定原始音乐生成任务的唯一标识符。可以是以下接口返回的 `task_id`： • 生成音乐 • 扩展音乐
`audio_id`	`string`	必需	指定要创建 Persona 的音频 ID
`name`	`string`	必需	为 Persona 指定一个易于识别的名称
`description`	`string`	必需	描述 Persona 的音乐特征、风格和个性

开发者注意事项

重要提示

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

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

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

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

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

生成音乐

扩展音乐

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

参数示例

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

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

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

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location 'https://api.kie.ai/api/v1/jobs/createTask' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "ai-music-api/generate-persona", "callBackUrl": "https://api.example.com/callback", "input": { "task_id": "5c79****be8e", "audio_id": "e231****-****-****-****-****8cadc7dc", "name": "Electronic Pop Singer", "description": "A modern electronic music style pop singer, skilled in dynamic rhythms and synthesizer tones", "vocal_start": 0, "vocal_end": 30, "style": "Electronic Pop" } }'

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

使用指南

参数详情

开发者注意事项

参数示例

Request

Responses

生成 Persona

使用指南#

参数详情#

开发者注意事项#

参数示例#

Request

Responses

使用指南

参数详情

开发者注意事项

参数示例