Skip to main content
POST
/
suno
/
persona
/
voice
/
create
cURL
curl https://api.deerapi.com/suno/persona/voice/create \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEERAPI_KEY" \
  -d '{
    "name": "mytitle",
    "description": "my voice persona",
    "is_public": true,
    "persona_type": "vox",
    "vocal_start_s": 0,
    "vocal_end_s": 23.24,
    "user_input_styles": "pop",
    "source": "random_song",
    "singer_skill_level": "Intermediate",
    "is_voice_recording": true,
    "vox_audio_id": "9e196fa1-20f3-43c1-8066-06a2a6b6bea9",
    "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768",
    "verification_id": "979282b1-8968-46bc-b599-ea14946be48e"
  }'
{
  "id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.deerapi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Use this endpoint to call the Suno Voice Create 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
​
name
string
required

Persona name

​
persona_type
enum<string>
required

Must be vox

Available options:
vox
​
vox_audio_id
string
required

vox_audio_id from the upload voice step

​
voice_recording_id
string
required

voice_recording_id from the upload voice step

​
verification_id
string
required

verification_id from the voice verification step

​
description
string

Persona description

​
image_s3_id
string

Image in Base64 format (data:image/jpeg;base64,...)

​
is_public
boolean

Whether the persona is public (note: always reset to false regardless of input)

​
vocal_start_s
number

Vocal start time (seconds)

​
vocal_end_s
number

Vocal end time (seconds)

​
user_input_styles
string

Style description

​
source
string

Source type

​
singer_skill_level
enum<string>

Singer skill level

Available options:
Advanced,
Intermediate,
Beginner,
Professional
​
is_voice_recording
boolean

Whether this is a voice recording

Response

200 - application/json

Success

​
id
string

Successfully created persona_id