guide

Suno Persona API指南：实现一致的声音风格

Q: 我可以在旧版模型中使用 persona_id 吗？

不可以。Persona功能需要 suno-v4 或更高版本。

Q: 我的persona ID有效期是多久？

请查阅当前服务提供商的文档，了解persona ID的生命周期和可用性详情。 ---

EvoLink Team

Product Team

2026年3月28日

4 分钟阅读

Suno Persona API指南：实现一致的声音风格

Meta Description: 学习如何使用Suno Persona API和 persona_id 在多次音乐生成中保持一致的声音风格。面向开发者的技术指南。

概要

目标：在不同的音乐生成中保持声音和风格的一致性。
关键参数：persona_id 和 custom_mode=True。
工作流：从已有曲目创建Persona → 获取 persona_id → 在后续生成中使用。
集成方式：在 /v1/audios/generations 任务提交时传入 persona_id。

什么是Suno Persona API？

Suno Persona API 允许开发者锁定特定的声音和风格特征。通过复用特定的 persona_id，你可以确保歌手的音色、风格和表现力在不同歌词和段落中保持一致。

为什么使用Persona API？

品牌建设：为播客片头或广告曲保持一致的"品牌声音"。
一致性：为系列剧集或多段叙事歌曲保持相同的歌手。
角色设计：在游戏或视频项目中为不同角色分配特定的声音"人设"。

如何开始使用Persona API

persona_id 不是凭空生成的，而是从已有的音乐中提取的。典型的工作流如下：

生成基准曲目：使用标准生成API创建一首Suno曲目。
创建Persona：使用已成功生成曲目的 id 调用Persona创建端点。
获取ID：API将返回一个唯一的 persona_id。
复用：在后续的生成请求中传入此 persona_id 以应用该声音风格。

技术实现

使用Persona提交生成任务

要应用Persona，需在POST请求 /v1/audios/generations 时包含 persona_id。根据公开文档，persona_id 和 persona_model 参数仅在 custom_mode 设置为 True 时生效。

import requests

API_KEY = "sk-your-evolink-key"
BASE_URL = "https://api.evolink.ai/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

def submit_persona_task(prompt, persona_id):
    url = f"{BASE_URL}/audios/generations"
    payload = {
        "model": "suno-v5-beta",
        "prompt": prompt,
        "persona_id": persona_id,
        "custom_mode": True
    }
    response = requests.post(url, headers=headers, json=payload)
    response.raise_for_status()
    # Returns 'id' as the task identifier
    return response.json()["id"]

task_id = submit_persona_task(
    prompt="Upbeat pop chorus about city lights",
    persona_id="your-unique-persona-id"
)
print(f"Task submitted with id: {task_id}")

获取结果

使用 GET /v1/tasks/{task_id} 端点轮询完成状态。音频URL位于 result_data 数组中。

def get_song_result(task_id):
    url = f"{BASE_URL}/tasks/{task_id}"
    while True:
        response = requests.get(url, headers=headers)
        data = response.json()

        if data["status"] == "completed":
            # Access result from result_data array
            return data["result_data"][0]["audio_url"]
        elif data["status"] == "failed":
            raise Exception(f"Task failed: {data.get('error')}")

        time.sleep(5)