跳转到主要内容
POST
/
api
/
v1
/
client
/
job
/
suno-persona-generate
生成 Suno 人物
curl --request POST \
  --url https://api.crun.ai/api/v1/client/job/suno-persona-generate \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "task_id": "task_12345678",
  "suno_id": "suno_abc123",
  "name": "霓虹女妖",
  "description": "一位烟熏感的深夜 R&B 女声，音色空灵且温暖，带有亲密感。",
  "vocal_start": 12.5,
  "vocal_end": 64,
  "style": "西方 R&B，情绪化，私密感"
}
'
{
  "code": 200,
  "message": "success",
  "data": {
    "persona_id": "persona_123456"
  }
}

​
API 接口地址

POST https://api.crun.ai/api/v1/client/job/suno-persona-generate
该接口在完成校验后会同步返回 persona_id。
生成后的 persona_id 可用于音乐生成、扩展、上传扩展以及翻唱等接口。

​
请求示例

{
    "task_id": "task_12345678",
    "suno_id": "suno_abc123",
    "name": "霓虹女妖",
    "description": "一位烟熏感的深夜 R&B 女声歌手，音色轻柔空灵，高音细腻且富有亲密感。",
    "vocal_start": 12.5,
    "vocal_end": 64.0,
    "style": "西方 R&B，氛围感，情绪化，私密感"
}

​
响应示例

success
{
    "code": 200,
    "message": "success",
    "data": {
        "persona_id": "persona_123456"
    }
}
error
{
    "code": 422,
    "message": "task_id 不存在",
    "data": null
}

​
相关资源

生成音乐

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

扩展音乐

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

上传扩展

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

音乐翻唱

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

授权

​
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