Skip to main content
POST
/
api
/
v1
/
client
/
job
/
suno-persona-generate
Generate a Suno persona
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": "Neon Siren",
  "description": "A smoky, late-night R&B vocalist with airy highs and a warm, intimate tone.",
  "vocal_start": 12.5,
  "vocal_end": 64,
  "style": "Western R&B, moody, intimate"
}
'
{
  "code": 200,
  "message": "success",
  "data": {
    "persona_id": "persona_123456"
  }
}

​
API Endpoint

POST https://api.crun.ai/api/v1/client/job/suno-persona-generate
This endpoint returns the persona ID synchronously after validation. Use the returned persona_id with Suno music generation, extension, upload extension, and cover endpoints.

​
Request Example

{
    "task_id": "task_12345678",
    "suno_id": "suno_abc123",
    "name": "Neon Siren",
    "description": "A smoky, late-night R&B vocalist with airy highs and a warm, intimate tone.",
    "vocal_start": 12.5,
    "vocal_end": 64.0,
    "style": "Western R&B, moody, intimate"
}

​
Response Example

success
{
    "code": 200,
    "message": "success",
    "data": {
        "persona_id": "persona_123456"
    }
}
error
{
    "code": 422,
    "message": "task_id not found",
    "data": null
}

Generate Music

Create songs from text prompts with diverse styles.

Extend Music

Continue and expand existing music seamlessly.

Extend Upload

Upload audio to extend and refine compositions.

Music Cover

Recreate songs in new styles or voices.

Authorizations

​
x-api-key
string
header
required

All APIs require authentication via API Key.

Get API Key:

  1. Visit API Key Management Page to get your API Key

Usage: Add to request header:

x-api-key: YOUR_API_KEY

Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately in the management page

Body

application/json
​
task_id
string
required

Task ID of the music generation task.

Example:

"task_12345678"

​
suno_id
string
required

Suno song ID.

Example:

"suno_abc123"

​
name
string
required

Persona name.

Maximum string length: 100
Example:

"Neon Siren"

​
description
string
required

Persona description.

Maximum string length: 1000
Example:

"A smoky, late-night R&B vocalist with airy highs and a warm, intimate tone."

​
vocal_start
number

Vocal start time in seconds.

Required range: x >= 0
Example:

12.5

​
vocal_end
number

Vocal end time in seconds.

Required range: x >= 0
Example:

64

​
style
string

Style.

Maximum string length: 1000
Example:

"Western R&B, moody, intimate"

Response

Request successful

​
code
enum<integer>
required

Response status code

  • 200: Success - Request has been processed successfully
  • 401: Unauthorized - Authentication credentials are missing or invalid
  • 402: Insufficient Credits - Account does not have enough credits to perform the operation
  • 404: Not Found - The requested resource or endpoint does not exist
  • 422: Validation Error - The request parameters failed validation checks
  • 429: Rate Limited - Request limit has been exceeded for this resource
  • 455: Service Unavailable - System is currently undergoing maintenance
  • 500: Server Error - An unexpected error occurred while processing the request
  • 501: Generation Failed - Content generation task failed
  • 505: Feature Disabled - The requested feature is currently disabled
Available options:
200,
401,
402,
404,
422,
429,
455,
500,
501,
505
​
message
string
required

Response message

Example:

"success"

​
data
object