> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snapgen.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno Persona

> Save the singer of a Suno track as a reusable Persona. $0.006 per request.

`suno-persona` saves the singer of one of your tracks as a Persona. Pass this task's `id` as `persona_task_id` to sing later songs with that Persona.

| Property | Value |
| - | - |
| Model ID | `suno-persona` |
| Endpoint | `POST /v1/music/generations` (asynchronous task) |
| Group | Suno > Vocals & stems |
| Input | A track from one of your earlier tasks and a Persona name |
| Result | A Persona in `result.persona` |
| Price | \$0.006 per request (0.6 credits) |

Confirm live rates on the [SnapGen models page](https://snapgen.org/models). Failed tasks are not charged.

<ParamField body="model" type="string" required>
  Set to `suno-persona`.
</ParamField>

<ParamField body="source_task_id" type="string" required>
  The `id` of your earlier task that holds the source track. It must be your own task, must have succeeded, and must come from a model listed in [Source tracks](#source-tracks).
</ParamField>

<ParamField body="source_index" type="integer" default="1">
  Position of the source track in that task's `result.tracks`, counting from `1` (up to `8`).
</ParamField>

<ParamField body="name" type="string" required>
  Persona name, up to 100 characters.
</ParamField>

<ParamField body="describe" type="string">
  Description of the Persona, up to 1,000 characters.
</ParamField>

<ParamField body="styles" type="string">
  Styles that suit the Persona, up to 1,000 characters.
</ParamField>

<ParamField body="vocal_start_s" type="number">
  Start of the vocal passage to learn from, in seconds (from 0 to 3,600).
</ParamField>

<ParamField body="vocal_end_s" type="number">
  End of that vocal passage, in seconds. Must be greater than `vocal_start_s`.
</ParamField>

<ParamField body="webhook" type="string">
  Optional public `https` URL that receives one signed event when the task finishes. See [Task webhooks](/api-reference/webhooks).
</ParamField>

<ParamField body="webhook_secret" type="string">
  Required with `webhook`: 16 to 256 characters, used to sign the delivery.
</ParamField>

## Request rules

The gateway checks these before it reserves any balance:

* When you send both, `vocal_end_s` must be greater than `vocal_start_s`.

## Source tracks

The source task must be your own succeeded task from one of these models:

[`suno-music`](/api-manual/audio/suno-music), [`suno-inspo`](/api-manual/audio/suno-inspo), [`suno-sounds`](/api-manual/audio/suno-sounds), [`suno-upload`](/api-manual/audio/suno-upload), [`suno-upload-cover`](/api-manual/audio/suno-upload-cover), [`suno-upload-extend`](/api-manual/audio/suno-upload-extend), [`suno-extend`](/api-manual/audio/suno-extend), [`suno-cover`](/api-manual/audio/suno-cover), [`suno-remaster`](/api-manual/audio/suno-remaster), [`suno-add-vocals`](/api-manual/audio/suno-add-vocals), [`suno-add-instrumental`](/api-manual/audio/suno-add-instrumental), [`suno-add-stem`](/api-manual/audio/suno-add-stem), [`suno-replace-section`](/api-manual/audio/suno-replace-section), [`suno-remove-section`](/api-manual/audio/suno-remove-section), [`suno-crop`](/api-manual/audio/suno-crop), [`suno-fade-in`](/api-manual/audio/suno-fade-in), [`suno-fade-out`](/api-manual/audio/suno-fade-out), [`suno-speed`](/api-manual/audio/suno-speed), [`suno-concat`](/api-manual/audio/suno-concat), [`suno-mashup`](/api-manual/audio/suno-mashup), [`suno-sample`](/api-manual/audio/suno-sample).

Send the task `id` as `source_task_id` and pick the track with `source_index`. Never send provider track or clip IDs. See [Reference earlier tasks](/api-reference/music-generations#reference-earlier-tasks).

## Request

```bash theme={null}
curl https://api.snapgen.org/v1/music/generations \
  -H "Authorization: Bearer $SNAPGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-persona",
    "source_task_id": "task_2f8KcX1mQpR7vT0yZa9Lb3",
    "source_index": 1,
    "name": "Midnight singer",
    "styles": "pop"
  }'
```

The response is HTTP `202` with a task object and a `Location: /v1/tasks/{id}` header. Poll [`GET /v1/tasks/{id}`](/api-reference/task-status) every 10 to 20 seconds until `status` is `succeeded` or `failed`.

## Result

The Persona ID is in `result.persona.id`. To sing with the Persona later, pass this task's `id` as `persona_task_id`; you never send the Persona ID itself.

```json theme={null}
{
  "urls": [],
  "persona": {
    "id": "persona_5e2b91"
  }
}
```

## Use it in later requests

Pass this task's `id` as `persona_task_id` to any of these models: [`suno-music`](/api-manual/audio/suno-music), [`suno-upload-cover`](/api-manual/audio/suno-upload-cover), [`suno-upload-extend`](/api-manual/audio/suno-upload-extend), [`suno-extend`](/api-manual/audio/suno-extend), [`suno-cover`](/api-manual/audio/suno-cover), [`suno-mashup`](/api-manual/audio/suno-mashup). The Persona applies in custom mode and can't be combined with `custom_model_task_id`.

<Note>
  See [Music generation tasks](/api-reference/music-generations) for the task lifecycle, result fields, webhooks, and errors.
</Note>