众扬汇 AI 开放平台 API 文档

场景九: Persona.歌手风格

A.生成音乐

通过场景 1 / 2 / 3 生成音乐,取出其中一首的 clip_id,本示例记为 54834687-5e79-4f08-8e14-cf188f15b598。

B.新建 Persona

post https://api.allyang.cn/suno/persona/create/

要求:clip_id 必须是平台内已存在的作品,且不能是上传者(uploader)来源;该能力不支持跨账号复用。 该接口会按要求扣减一定费用用于防止滥用(原文口径为“扣 100 积分”,与我方人民币计费不一致,实际费用待补,以控制台「日志与用量」为准)。

请求体

json
{
  "root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
  "name": "<Persona 标题>",
  "description": "<Persona 描述>",
  "clips": ["54834687-5e79-4f08-8e14-cf188f15b598"],
  "is_public": true
}

返回示例(关键字段)

json
{
  "id": "fd213afd-ac1c-4822-9802-c1c0ea45e77b",
  "name": "<Persona 标题>",
  "description": "<Persona 描述>",
  "root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
  "clip": { "id": "<clip_id>", "video_url": "<视频地址>", "audio_url": "<音频地址>", "image_url": "<封面地址>", "image_large_url": "<大图地址>", "major_model_version": "v4", "model_name": "chirp-v4", "metadata": { "tags": "<风格标签>", "prompt": "", "type": "gen", "duration": 190, "refund_credits": false, "stream": true }, "is_liked": false, "user_id": "<user_id>", "display_name": "<昵称>", "handle": "<handle>", "is_handle_updated": false, "avatar_image_url": "<头像地址>", "is_trashed": false, "created_at": "<创建时间>", "status": "complete", "title": "<标题>", "play_count": 0, "upvote_count": 0, "is_public": false },
  "user_display_name": "<昵称>",
  "user_handle": "<handle>",
  "user_image_url": "<头像地址>",
  "persona_clips": [ { "clip": { "...": "同上 clip 结构" }, "id": 11288925 } ]
}

返回体中的 id 即 persona_id,供下一步使用。

C.使用 persona_id 创作

post https://api.allyang.cn/suno/generate

注意:mv 取 chirp-v3-5-tau 或 chirp-v4-tau;task 固定为 artist_consistency;persona_id 取 B 步骤返回的 id;artist_clip_id 取 A 步骤的 clip_id。

json
{
  "prompt": "<歌词>",
  "generation_type": "TEXT",
  "tags": "electronic, pop",
  "negative_tags": "",
  "mv": "chirp-v4-tau",
  "title": "<标题>",
  "task": "artist_consistency",
  "persona_id": "<persona_id>",
  "artist_clip_id": "<artist_clip_id>"
}

返回示例(关键字段,clips 含两条结果)

json
{
  "id": "<任务 id>",
  "clips": [
    {
      "id": "<新 clip id>",
      "video_url": "<视频地址>",
      "audio_url": "<音频地址>",
      "major_model_version": "v4",
      "model_name": "chirp-v4",
      "metadata": { "tags": "electronic, pop", "prompt": "<歌词>", "type": "gen", "stream": true, "has_vocal": false, "artist_clip_id": "<artist_clip_id>", "persona_id": "<persona_id>", "task": "artist_consistency" },
      "is_liked": false,
      "user_id": "<user_id>",
      "display_name": "<昵称>",
      "handle": "<handle>",
      "is_handle_updated": false,
      "avatar_image_url": "<头像地址>",
      "is_trashed": false,
      "created_at": "<创建时间>",
      "status": "submitted",
      "title": "<标题>",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    }
  ],
  "metadata": { "tags": "electronic, pop", "prompt": "<歌词>", "type": "gen", "stream": true, "has_vocal": false, "artist_clip_id": "<artist_clip_id>", "persona_id": "<persona_id>", "task": "artist_consistency" },
  "major_model_version": "v4",
  "status": "complete",
  "created_at": "<创建时间>",
  "batch_size": 1
}