> ## 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 Cover

> Cover one of your tracks in a different style with Suno. $0.075 per request, $0.15 in Max mode.

`suno-cover` covers one of your tracks in a different style.

| Property | Value |
| - | - |
| Model ID | `suno-cover` |
| Endpoint | `POST /v1/music/generations` (asynchronous task) |
| Group | Suno > Edit |
| Input | A track from one of your earlier tasks, plus lyrics or a description |
| Result | Tracks in `result.tracks` with `audio_url` |
| Price | \$0.075 per request (7.5 credits); \$0.15 with `max_mode: true` |

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-cover`.
</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="version" type="string" default="v6">
  Suno model version: `v6`, `v6-wild`, or `v6-mini`. Omit it when you send `custom_model_task_id`.
</ParamField>

<ParamField body="custom_model_task_id" type="string">
  The `id` of a succeeded [`suno-custom-model`](/api-manual/audio/suno-custom-model) task. Generates with that custom model instead of a public `version`, so don't send `version` or `persona_task_id`.
</ParamField>

<ParamField body="custom" type="boolean">
  `true` is custom mode: `prompt` holds the lyrics and the style fields apply. `false` is description mode: `gpt_description` guides the result and is required, and `max_mode` and `duration` aren't allowed. Send it explicitly; if you omit it, the provider infers the mode from the fields you send.
</ParamField>

<ParamField body="prompt" type="string">
  Lyrics, up to 5,000 characters. Applies in custom mode.
</ParamField>

<ParamField body="gpt_description" type="string">
  Description-mode prompt, up to 3,000 characters. Required when `custom` is `false`.
</ParamField>

<ParamField body="title" type="string">
  Track title, up to 80 characters. Applies in custom mode.
</ParamField>

<ParamField body="tags" type="string">
  Style tags, up to 1,000 characters. Applies in custom mode.
</ParamField>

<ParamField body="negative_tags" type="string">
  Styles to avoid, up to 1,000 characters. Applies in custom mode.
</ParamField>

<ParamField body="style_weight" type="number">
  Style weight, from 0 to 1. Applies in custom mode.
</ParamField>

<ParamField body="weirdness" type="number">
  Creativity, from 0 to 1. Higher values are more experimental.
</ParamField>

<ParamField body="audio_weight" type="number">
  Audio weight, from 0 to 1. Applies in custom mode.
</ParamField>

<ParamField body="vocal_gender" type="string">
  `male` or `female` vocals.
</ParamField>

<ParamField body="variety" type="string">
  Style variation: `off`, `normal`, `high`, `extra`, or `max`. It doesn't turn on Max mode or change the price.
</ParamField>

<ParamField body="max_mode" type="boolean" default="false">
  `true` turns on Suno Max mode and bills twice the request price. Not allowed with `custom: false`.
</ParamField>

<ParamField body="audio_format" type="string">
  Output format: `mp3`, `m4a`, or `wav`. The provider picks one if you omit it.
</ParamField>

<ParamField body="persona_task_id" type="string">
  The `id` of a succeeded [`suno-persona`](/api-manual/audio/suno-persona) task. The song is sung with that Persona. Applies in custom mode. Can't be combined with `custom_model_task_id`.
</ParamField>

<ParamField body="duration" type="integer">
  Target length in seconds, from 10 to 360. The finished track can be shorter or longer. Not allowed with `custom: false`.
</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:

* `custom: false` requires `gpt_description`.
* `max_mode` and `duration` aren't allowed with `custom: false`.
* Send either `version` or `custom_model_task_id`, not both.
* `persona_task_id` can't be combined with `custom_model_task_id`.

## 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-cover",
    "source_task_id": "task_2f8KcX1mQpR7vT0yZa9Lb3",
    "source_index": 1,
    "tags": "jazz, slow"
  }'
```

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

`result.tracks[]` lists every track in its original order, each with its `index` and `audio_url`, plus `title`, `image_url`, `duration_seconds`, `lyrics`, and `tags` when the provider returns them. `result.urls` lists the audio URLs.

```json theme={null}
{
  "urls": [
    "https://cdn.example.com/music/night-drive.mp3"
  ],
  "tracks": [
    {
      "index": 1,
      "id": "clip_8f3a2c",
      "title": "Night Drive",
      "audio_url": "https://cdn.example.com/music/night-drive.mp3",
      "image_url": "https://cdn.example.com/music/night-drive.jpg",
      "duration_seconds": 184.6,
      "tags": "lo-fi, soft piano, rain"
    }
  ]
}
```

<Note>
  Result URLs are kept for about 72 hours. Download the files you want to keep.
  See [Music generation tasks](/api-reference/music-generations) for the task lifecycle, result fields, webhooks, and errors.
</Note>