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

> Cover a public audio file in a new style with Suno. $0.075 per request, $0.15 in Max mode.

`suno-upload-cover` creates a cover of a public audio file in a new style, without a separate upload step.

| Property | Value |
| - | - |
| Model ID | `suno-upload-cover` |
| Endpoint | `POST /v1/music/generations` (asynchronous task) |
| Group | Suno > Upload |
| Input | One public audio URL, 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-upload-cover`.
</ParamField>

<ParamField body="audio_url" type="string" required>
  Public `http` or `https` URL of the song. The provider recommends keeping it under 8 minutes.
</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, where the provider requires it unless `instrumental` is `true`.
</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.
</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.
</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="instrumental" type="boolean" default="false">
  `true` makes an instrumental with no vocals.
</ParamField>

<ParamField body="auto_lyrics" type="boolean">
  `true` rewrites the lyrics you send creatively.
</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. 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`.

## 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-upload-cover",
    "audio_url": "https://example.com/reference.mp3",
    "custom": true,
    "instrumental": true,
    "tags": "piano, ambient"
  }'
```

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>