AIGC API Service

Appearance

Suno Persona 创建 ​

Persona 用于保存某首歌曲或某段人声的歌手风格，后续可在歌曲生成、续写或翻唱时通过 persona_id 复用该风格。

接口地址 ​

http
POST /suno/persona

请求参数 ​

参数类型必填默认值说明
audio_idstring是-来源歌曲 ID
namestring否-Persona 名称，最长 200
descriptionstring否-Persona 描述，最长 1000
image_urlstring否-Persona 封面图片 URL，也可以传 data:image/png;base64,...
is_uploadboolean/string否false是否先按上传流程处理音频
audio_urlstring否-is_upload 为 true 时使用的音频 URL
persona_typestring否defaultPersona 类型，default 或 vox
vox_audio_idstring否-Vox 提取结果 ID，用于创建 Vox Persona
vocal_startstring否-Vox 人声片段起始时间
vocal_endstring否-Vox 人声片段结束时间
vocal_stylestring否-Vox 人声风格
async_modeboolean否false是否使用异步模式

普通 Persona ​

先生成一首适合用作歌手风格来源的歌曲，然后使用该歌曲的 data[].id 创建 Persona。

请求示例：

json
{
  "name": "新年快乐",
  "description": "新年快乐",
  "audio_id": "04734644-d4c8-4d1e-ac53-be95289c5b6b",
  "async_mode": false
}

响应示例：

json
{
  "success": true,
  "task_id": "7a603203-918a-4ce7-8d7c-5e772a62861b",
  "data": {
    "persona_id": "89f20346-51f0-4b35-a88e-ed8fa5bb5cac",
    "name": "新年快乐",
    "description": "新年快乐"
  }
}

创建成功后，后续在歌曲生成接口中使用 persona_id 即可复用该歌手风格。

上传音频创建 Persona ​

如果创建 Persona 时歌曲出现不可用或下线，可以传入 is_upload、audio_url 和 image_url。其中 image_url 为封面图片，支持图片链接或 base64 data URL。

请求示例：

json
{
  "audio_id": "317a41e5-c308-49c3-bef0-ee7ae38fb633",
  "image_url": "https://cdn.yoy-ai.com/56xjbz.png",
  "is_upload": true,
  "audio_url": "https://cdn1.suno.ai/ee283391-a93a-4769-8a37-26bd4f63525a.mp3",
  "async_mode": false
}

is_upload 为 true 时，上传流程可能会生成新的 audio_id，最终请以响应中的 audio_id 为准。

响应示例：

json
{
  "success": true,
  "task_id": "a244bdb3-c1dc-4c87-831c-104ba450bd0c",
  "data": {
    "persona_id": "acf6f159-263f-4e17-bed3-80beb2c00e42",
    "name": "",
    "description": "",
    "image_url": "https://cdn1.suno.ai/2d6e4fe4.png",
    "audio_id": "50ddcc2b-5376-402e-aad7-c5d15d53a860"
  }
}

Vox Persona ​

Vox Persona 适合从歌曲中提取一段人声，再基于该人声创建 Persona。流程分两步：

  1. 调用 Vox 提取接口获取 vox_audio_id、vocal_start、vocal_end。
  2. 调用 Persona 创建接口，传入 persona_type: "vox"。

Vox 提取请求示例：

json
{
  "audio_id": "d9c20912-eadf-4f02-986d-ee07347f93f8"
}

Vox 提取响应示例：

json
{
  "success": true,
  "task_id": "63cace08-cc56-4dc4-92f0-2769fdb3343f",
  "trace_id": "01292496-4c4b-4586-b8d3-506bbc6ebd99",
  "data": {
    "id": "31c92480-ae3c-448d-a2df-b71e16fde075",
    "root_clip_id": "d9c20912-eadf-4f02-986d-ee07347f93f8",
    "vocal_audio_url": "https://cdn1.suno.ai/processed_31c92480.mp3",
    "state": "succeeded",
    "vocal_start": 45,
    "vocal_end": 74
  }
}

创建 Vox Persona 请求示例：

json
{
  "name": "新年快乐",
  "description": "新年快乐",
  "audio_id": "d9c20912-eadf-4f02-986d-ee07347f93f8",
  "vox_audio_id": "31c92480-ae3c-448d-a2df-b71e16fde075",
  "persona_type": "vox",
  "vocal_start": 45,
  "vocal_end": 74,
  "async_mode": false
}

响应示例：

json
{
  "success": true,
  "task_id": "40025a3f-4d0c-4230-9721-a33d65c2156a",
  "data": {
    "persona_id": "7eaf1030-191a-4ed9-9314-f9a642d56e31",
    "name": "新年快乐",
    "description": "新年快乐",
    "image_url": "https://cdn2.suno.ai/image_d9c20912.jpeg",
    "audio_id": "d9c20912-eadf-4f02-986d-ee07347f93f8"
  }
}

真人 Voice Persona ​

真人 Voice 需要先初始化 Voice，获取验证短语，然后上传朗读验证短语的音频完成验证并创建 Persona。

初始化 Voice 请求示例：

json
{
  "voice_audio_url": "https://cos.yoy-ai.com/xxx.m4a",
  "language": "zh",
  "vocal_start": 0,
  "vocal_end": 12
}

language 支持以下值：

text
en, es, fr, pt, de, ja, ko, zh, hi, ru

初始化结果中的常用字段：

字段说明
vox_audio_id提取的人声 ID，验证 Voice 需要
voice_recording_id原声录音 ID，验证 Voice 需要
phrase_id验证短语 ID
phrase_text验证短语文本，需要朗读并录制为音频
vocal_audio_url提取后的人声音频 URL
vocal_start / vocal_end人声时间范围

验证 Voice 请求示例：

json
{
  "vox_audio_id": "aca20afa-0e70-4428-b54d-d138f70fb238",
  "voice_recording_id": "35caebb6-e1cf-49ea-82a8-9677fa334b96",
  "phrase_id": "c46c587a-1f23-48a6-a7ee-e5bff3301849",
  "vocal_start": 0,
  "vocal_end": 12,
  "verification_audio_url": "https://cos.yoy-ai.com/xxx.m4a",
  "name": "llz"
}

响应示例：

json
{
  "success": true,
  "task_id": "52cccff6-8563-474d-ab55-ff696cb51d1d",
  "trace_id": "b52e41ca-3823-4016-835f-44be72e0f353",
  "data": {
    "persona_id": "b224d9c9-d23d-4425-803b-9af41f94d3e1",
    "name": "llz",
    "description": "",
    "audio_id": "aca20afa-0e70-4428-b54d-d138f70fb238"
  }
}

验证成功后，可以在歌曲生成接口中使用返回的 persona_id 生成真人 Voice 风格歌曲。

Python 示例 ​

python
import requests

url = "https://your-domain.com/suno/persona"
headers = {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "audio_id": "audio-id",
    "name": "Warm Female Pop",
}

response = requests.post(url, headers=headers, json=payload)
print(response.text)

响应说明 ​

默认异步模式下通常会返回任务信息，可通过 任务查询 获取结果。创建成功后，请保存响应中的 persona_id。

扣费说明 ​

功能参考积分
Persona 创建4