Sign in

v1

latestOpenAPI 3.1.0MIT2026-07-2614271305.9 KB
Audio Generation

Suno Persona Creation API

  • Extract reusable Persona (vocal/style characteristics) from completed Suno music generation tasks
  • After successful creation, a persona_id is returned, which can be applied in subsequent Suno Music Generation via persona_id and persona_model parameters
  • Source task model version must be suno-v4 or above (v3.5 not supported)
  • Each song (result_id) can only create one Persona
  • Asynchronous processing mode, use the returned task ID to query status
  • Cannot create a new Persona from a Persona task
post/v1/audios/generations

Request body

model'suno-persona' required

Model name, fixed as suno-persona

Example request

{
  "model": "suno-persona",
  "model_params": {
    "source_task_id": "task-unified-1774169216-ocqaqde7",
    "result_id": "4fcc4507-a7ae-4441-ad8a-465c2f61d5bb",
    "name": "Electronic Pop Singer",
    "description": "Modern electronic style with energetic beats and synthesizer tones for dance music",
    "vocal_start": 10,
    "vocal_end": 30,
    "style": "electronic pop"
  }
}

Response

Persona creation task submitted successfully

createdinteger

Task creation timestamp

idstring

Task ID, used to query task status and results

modelstring

Actual model name used

object'audio.generation.task'

Task type

progressinteger

Task progress percentage (0-100)

status'pending' | 'processing' | 'completed' | 'failed'

Task status

type'audio'

Task output type

Example response

{
  "created": 1774170584,
  "id": "task-unified-1774170584-su75smg7",
  "model": "suno-persona",
  "status": "pending",
  "task_info": {
    "estimated_time": 15
  },
  "type": "audio",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 5,
    "user_group": "default"
  }
}