众扬汇 AI 开放平台 API 文档

Persona:创建歌手风格

OpenAPI Specification

接口:POST /suno/persona/create/(完整地址 https://api.allyang.cn/suno/persona/create/)

鉴权:请求头 Authorization 传令牌,取值形如 Bearer {{YOUR_API_KEY}}(原文该字段非必填)。

请求头

  • content-type:必填,固定 application/json。
  • accept:可选,原文示例 */*。

请求体参数(application/json)

下列 5 个字段在原文中全部标为必传。

  • root_clip_id:必填,string,来源片段的标识;原文示例给出一串 UUID,此处待补。
  • name:必填,string,风格名称,原文示例为标题文案。
  • description:必填,string,风格的文字说明。
  • clips:必填,string 数组,参与合成的片段标识列表,原文示例只放了 1 个元素。
  • is_public:必填,boolean,原文示例为 true。

响应

  • 200:成功,返回 JSON 对象。
  • 原文档提示:把响应体里的 id 记为 persona_id,供后续流程引用;其余字段结构未给出,待补。

使用提示:本平台 Base URL 为 https://api.allyang.cn,OpenAI 兼容接口路径以 /v1 开头;示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。 该风格与创建它的账号绑定,无法在账号之间共用;账号停用后可能就无法继续调用。 root_clip_id 必须指向系统内已经存在的片段,不能填上传者自己名下的片段。