Skip to main content
POST
/
suno
/
persona
/
create
新建 Persona
curl --request POST \
  --url https://api.deerapi.com/suno/persona/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "root_clip_id": "82294225-6537-4dfc-adcd-be3b5edaa46c",
  "name": "Persona 标题",
  "description": "Persona 描述",
  "clips": [
    "54834687-5e79-4f08-8e14-cf188f15b598"
  ],
  "is_public": true
}
'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "image_s3_id": "<string>",
  "root_clip_id": "<string>",
  "clip": {
    "id": "<string>",
    "entity_type": "<string>",
    "video_url": "<string>",
    "audio_url": "<string>",
    "image_url": "<string>",
    "image_large_url": "<string>",
    "major_model_version": "<string>",
    "model_name": "<string>",
    "metadata": {
      "tags": "<string>",
      "prompt": "<string>",
      "type": "<string>",
      "duration": 123,
      "refund_credits": true,
      "stream": true,
      "can_remix": true,
      "is_remix": true,
      "priority": 123
    },
    "is_liked": true,
    "user_id": "<string>",
    "display_name": "<string>",
    "handle": "<string>",
    "is_handle_updated": true,
    "avatar_image_url": "<string>",
    "is_trashed": true,
    "flag_count": 123,
    "display_tags": "<string>",
    "created_at": "<string>",
    "status": "<string>",
    "title": "<string>",
    "play_count": 123,
    "upvote_count": 123,
    "is_public": true,
    "allow_comments": true
  },
  "user_display_name": "<string>",
  "user_handle": "<string>",
  "user_image_url": "<string>",
  "persona_clips": [
    {
      "clip": {
        "id": "<string>",
        "entity_type": "<string>",
        "video_url": "<string>",
        "audio_url": "<string>",
        "image_url": "<string>",
        "image_large_url": "<string>",
        "major_model_version": "<string>",
        "model_name": "<string>",
        "metadata": {
          "tags": "<string>",
          "prompt": "<string>",
          "type": "<string>",
          "duration": 123,
          "refund_credits": true,
          "stream": true,
          "can_remix": true,
          "is_remix": true,
          "priority": 123
        },
        "is_liked": true,
        "user_id": "<string>",
        "display_name": "<string>",
        "handle": "<string>",
        "is_handle_updated": true,
        "avatar_image_url": "<string>",
        "is_trashed": true,
        "flag_count": 123,
        "display_tags": "<string>",
        "created_at": "<string>",
        "status": "<string>",
        "title": "<string>",
        "play_count": 123,
        "upvote_count": 123,
        "is_public": true,
        "allow_comments": true
      },
      "id": 123
    }
  ],
  "is_suno_persona": true,
  "is_trashed": true,
  "is_owned": true,
  "is_public": true,
  "is_public_approved": true,
  "is_loved": true,
  "upvote_count": 123,
  "clip_count": 123
}

​
🎵 生成Persona:歌手风格流程 🎵

​
🚀 操作步骤：

  1. step1. 通过生成音乐场景 1 2 3 任意一种生成音乐，且必须为4.5版本，取到 task id
  2. step2. 拿到 task id 后,根据需要获取歌曲的对应 clip_id 值
  3. step3. 将对应的 clip_id 入参， 填入该接口 ，得到返回的id为persona_id供下一步使用
  • 使用接口: 使用 persona_id 创作 注意事项:**
  • mv 为 chirp-v3-5-tau 或者 chirp-v4-tau 或者 chirp-auk
  • task 为 artist_consistency
  • persona_id 为 新建persona 接口 步骤得到的返回id
  • artist_clip_id 就是 生成音乐 步骤中的 clip_id

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Body

application/json
​
root_clip_id
string
default:example
required
​
name
string
default:example
required
​
description
string
default:example
required
​
clips
string[]
required
​
is_public
boolean
default:true
required

Response

200 - application/json

Successful Response

​
id
string
required
​
name
string
required
​
description
string
required
​
image_s3_id
string
required
​
root_clip_id
string
required
​
clip
object
required
​
user_display_name
string
required
​
user_handle
string
required
​
user_image_url
string
required
​
persona_clips
object[]
required
​
is_suno_persona
boolean
required
​
is_trashed
boolean
required
​
is_owned
boolean
required
​
is_public
boolean
required
​
is_public_approved
boolean
required
​
is_loved
boolean
required
​
upvote_count
integer
required
​
clip_count
integer
required