---
title: "Generate Persona"
method: POST
path: "/api/v1/generate/generate-persona"
tags: ["Music Generation"]
---

# Generate Persona

`POST /api/v1/generate/generate-persona`

## Request body

- object
  - `taskId` string, required — Unique identifier of the original music generation task. This can be a taskId returned from any of the following endpoints: - Generate Music (/api/v1/generate) - Extend Music (/api/v1/generate/extend)
  - `audioId` string, required — Audio ID of the music track to create Persona for.
  - `name` string, required — Name for the Persona. A descriptive name that captures the essence of the musical style or character.
  - `description` string, required — Detailed description of the Persona's musical characteristics, style, and personality. Be specific about genre, mood, instrumentation, and vocal qualities.
  - `vocalStart` number — Start time (in seconds) of the audio segment to analyze for Persona generation. Optional. Default value is 0.0. Must be between 0 and the audio duration. The segment length (vocalEnd - vocalStart) must be between 10-30 seconds.
  - `vocalEnd` number — End time (in seconds) of the audio segment to analyze for Persona generation. Optional. Default value is 30.0. Must be between 0 and the audio duration. The segment length (vocalEnd - vocalStart) must be between 10-30 seconds.
  - `style` string — Music style label to help categorize the Persona. Optional.

## Response `200`

Request successful

- object
  - `code` 200 | 401 | 402 | 404 | 409 | 422 | 429 | 451 | 455 | 500 — Response Status Codes - **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 - **409**: Conflict - Persona already exists for this music - **422**: Validation Error - The request parameters failed validation checks - **429**: Rate Limited - Request limit has been exceeded for this resource - **451**: Unauthorized - Failed to fetch the music data. Kindly verify any access limits set by you or your service provider - **455**: Service Unavailable - System is currently undergoing maintenance - **500**: Server Error - An unexpected error occurred while processing the request
  - `msg` string — Error message when code != 200
  - `data` object
    - `personaId` string — Unique identifier for the generated Persona. This personaId can be used in subsequent music generation requests (Generate Music, Extend Music, Upload And Cover Audio, Upload And Extend Audio) to create music with similar style characteristics.
    - `name` string — Name of the Persona as provided in the request.
    - `description` string — Description of the Persona's musical characteristics, style, and personality as provided in the request.

## Other responses

- `500` — Server error

---

[API](https://skmtc.dev/sunoapi/apis/file-upload-api.md) · [All operations](https://skmtc.dev/sunoapi/apis/file-upload-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sunoapi/file-upload-api/revisions/22d45ee33a4a/schema)