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

> Extend a public audio file from a chosen second with Suno. $0.075 per request, $0.15 in Max mode.

`suno-upload-extend` continues a public audio file from a chosen second, without a separate upload step.

| Property | Value |
| - | - |
| Model ID | `suno-upload-extend` |
| Endpoint | `POST /v1/music/generations` (asynchronous task) |
| Group | Suno > Upload |
| Input | One public audio URL and a start second, plus optional lyrics |
| 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-extend`.
</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="continue_at" type="number" required>
  Second in the song where the new part starts, from 1 to 3,600. Keep it below the song's length.
</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="prompt" type="string">
  Lyrics for the continuation, up to 5,000 characters. Omit it for an instrumental continuation.
</ParamField>

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

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

<ParamField body="negative_tags" type="string">
  Styles to avoid, up to 1,000 characters.
</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="auto_lyrics" type="boolean">
  `true` rewrites the lyrics you send creatively.
</ParamField>

<ParamField body="vocal_gender" type="string">
  `male` or `female` vocals.
</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.
</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.
</ParamField>

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

* 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-extend",
    "audio_url": "https://example.com/reference.mp3",
    "continue_at": 30,
    "tags": "acoustic 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

`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>