跳转到主要内容
POST
生成 Suno 人物

API 接口地址

该接口在完成校验后会同步返回 persona_id。
生成后的 persona_id 可用于音乐生成、扩展、上传扩展以及翻唱等接口。

请求示例


响应示例

success
error

相关资源

生成音乐

通过文本提示创建多种风格的歌曲。

扩展音乐

无缝续写并扩展已有音乐。

上传扩展

上传音频并对作品进行扩展与优化。

音乐翻唱

用新的风格或声音重新演绎歌曲。

授权

x-api-key
string
header
必填

所有 API 均需通过 API Key 进行身份认证。

获取 API Key:

  1. 访问 API Key 管理页面 获取 API Key

使用方式: 在请求头中添加:

x-api-key: YOUR_API_KEY

注意:

  • 请妥善保管 API Key,避免泄露
  • 如怀疑泄露请立即重置

请求体

application/json
task_id
string
必填

音乐任务 ID

示例:

"task_12345678"

suno_id
string
必填

Suno 歌曲 ID

示例:

"suno_abc123"

name
string
必填

人物名称

Maximum string length: 100
示例:

"霓虹女妖"

description
string
必填

人物描述

Maximum string length: 1000
示例:

"一位烟熏感的深夜 R&B 女声,音色空灵且温暖,带有亲密感。"

vocal_start
number

人声开始时间(秒)

必填范围: x >= 0
示例:

12.5

vocal_end
number

人声结束时间(秒)

必填范围: x >= 0
示例:

64

style
string

风格描述

Maximum string length: 1000
示例:

"西方 R&B,情绪化,私密感"

响应

请求成功

code
enum<integer>
必填

响应状态码

  • 200:成功
  • 401:未授权
  • 402:Credits 不足
  • 404:资源不存在
  • 422:参数校验失败
  • 429:请求过于频繁
  • 455:服务维护中
  • 500:服务器错误
  • 501:生成失败
  • 505:功能未启用
可用选项:
200,
401,
402,
404,
422,
429,
455,
500,
501,
505
message
string
必填

响应消息

示例:

"success"

data
object