Skip to main content
POST
创建角色
从已有 clip 创建已脱敏的片段 Persona。不绑声纹,任意账号可用。两个家族对比见 Persona 总览
此端点直接返回创建的角色(不是任务 ID)。对于声音角色(persona_type: "vox"),请先使用获取人声音轨提取人声音轨。
/generate 里使用本 Persona 时不要is_voice: true。该字段只给 Voice Persona(Clone Voice 或 Init+Complete)用。

请求体

string
必填
用于创建角色的音频片段 ID。
string
必填
角色名称。
boolean
默认值:true
必填
角色是否可公开访问。
string
角色描述。
string
角色类型。声音角色请使用 "vox"
string
获取人声音轨返回的人声音频 ID。声音角色必填。
number
要使用的声乐片段开始时间(秒)。
number
要使用的声乐片段结束时间(秒)。
string
描述角色的风格标签(例如 “soulful vocals, R&B, smooth harmonies”)。
string
角色头像的 Base64 编码图片(格式:data:image/png;base64,...)。

响应

响应包含完整的角色对象及所有详情。
string
创建的角色 ID。
string
角色名称。
string
角色描述。
string
角色类型(例如 "vox")。
boolean
角色是否公开。
object
源片段信息。
number
人声开始时间。
number
人声结束时间。

示例

响应示例

工作流程:创建声音角色

创建声音角色请按以下步骤操作:
创建后,可以通过 Generate Music 端点的 persona 参数使用角色,以创建具有一致声音特征的音乐。