Skip to main content
POST
/
suno
/
persona
/
create
cURL
curl https://api.deerapi.com/suno/persona/create \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEERAPI_KEY" \
  -d '{
    "root_clip_id": "82294225-6537-4dfc-adcd-be3b5edaa46c",
    "name": "Persona Title",
    "description": "Persona description",
    "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
}

​
Overview

Use this endpoint to call the Suno New Persona workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

​
Before you start

Use the DeerAPI base URL and pass your API Key in the Authorization header: 
https://api.deerapi.com

Authorization: Bearer $DEERAPI_KEY

​
Model selection

Choose a current model ID from the live pricing page. Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

​
Implementation notes

  • Use the OpenAPI playground for the exact request fields accepted by this endpoint.
  • Keep API Keys on the server side when you build production applications.
  • Log the request ID from failed calls so support can investigate the request.
  • Retry 429, 500, and 503 responses with exponential backoff.

Authorizations

​
Authorization
string
header
required

Use a DeerAPI API Key as a Bearer token.

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