场景九: 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
}