生成 Persona
POST
/api/v1/client/tasks
基于已生成的音乐创建个性化的音乐 Persona，为音乐赋予独特的身份和特征。
使用指南
taskId 和音频 ID参数详情
| 参数名 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
taskId | string | 必需 | 指定原始音乐生成任务的唯一标识符。可以是以下接口返回的 taskId：• 生成音乐 ( /api/v1/generate)• 扩展音乐 ( /api/v1/generate/extend) |
audioId | string | 必需 | 指定要创建 Persona 的音频 ID |
name | string | 必需 | 为 Persona 指定一个易于识别的名称 |
description | string | 必需 | 描述 Persona 的音乐特征、风格和个性 |
vocalStart | number | 可选 | 指定 Persona 分析片段的起始时间（秒），默认 0；必须小于 vocalEnd，且片段长度需在 10 到 30 秒之间 |
vocalEnd | number | 可选 | 指定 Persona 分析片段的结束时间（秒），默认 30；与 vocalStart 的差值需在 10 到 30 秒之间 |
style | string | 可选 | 补充与 Persona 对应的音乐风格标签，例如“电子流行”“爵士三重奏” |
开发者注意事项
重要提示
taskId（v3_5 本身不支持）。personaId 可以用于后续的音乐生成请求中，以创作具有相似风格特征的音乐。参数示例
{
"taskId": "5c79****be8e",
"audioId": "e231****-****-****-****-****8cadc7dc",
"name": "电子流行歌手",
"description": "具有现代电子音乐风格的流行歌手，擅长动感节奏和合成器音色",
"vocalStart": 0,
"vocalEnd": 30,
"style": "电子流行"
}taskId 对应的音乐生成任务已完成，且 audioId 在有效范围内。Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.emix.ai/api/v1/client/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno/generate-persona",
"callBackUrl": "https://example.com/callback",
"input": {
"taskId": "5c79****be8e",
"audioId": "e231****-****-****-****-****8cadc7dc",
"name": "电子流行歌手",
"description": "具有现代电子音乐风格的流行歌手，擅长动感节奏和合成器音色",
"vocalStart": 0,
"vocalEnd": 30,
"style": "电子流行"
}
}'Response Response Example
{
"code": 200,
"msg": "success",
"data": {
"taskId": "dc8ec31ea13cb53efa770acc552fe9e9",
"result": {
"persona_id": "dc8ec31ea13cb53efa770acc552fe9e9",
"name": "欢乐",
"description": "欢乐"
}
}
}