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

# Продление и загрузка

> extend продление; uploadTask/uploadCover/uploadExtend для загруженного аудио

Четыре операции делят один endpoint — `{operation}` выбирает поведение:

```
POST https://toapis.com/v1/music/generations/{operation}
```

## Authorizations

**Authorization** `string` *required*

Bearer Token. API Key:[страница управления](https://toapis.com/console/token)

## extend — продление трека($0.05, Max $0.10)

Продолжает генерацию с метки времени существующей задачи. `custom` по умолчанию `true`.

**model** `string` *required*

Фиксированное `"suno"`

**task\_id** `string` *required*

ID исходной задачи

**continue\_at** `number` *required*

Точка продолжения(сек)

**audio\_index** `number`

Номер трека

**prompt** `string`

Текст продолжения(custom)

**title** `string`

Название

**style** `string`

Теги стиля

**max\_mode** `boolean`

Max-тариф \$0.10

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/music/generations/extend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","task_id":"tsk_aud_xxx","continue_at":60,"prompt":"[Chorus] ..."}'
```

## uploadTask — регистрация загрузки(\$0.004)

Регистрирует публичный аудио-URL как задачу. Продукт — **обязательный источник** для `sample`/`addVocals`/`addInstrumental`/`addStem`.

**model** `string` *required*

Фиксированное `"suno"`

**audioFilePath** `string` *required*

Публично доступный URL аудио

> [!WARNING]
>
> Отправляйте только `model` + `audioFilePath`; лишние поля вроде `version` upstream отклоняет.

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/music/generations/uploadTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","audioFilePath":"https://example.com/my-vocals.mp3"}'
```

## uploadCover — загрузка + кавер($0.05, Max $0.10)

**model** `string` *required*

Фиксированное `"suno"`

**audio\_url** `string` *required*

URL исходного аудио

**custom** `boolean`

Режим кастомного текста

**prompt** `string`

Слова(custom=true) или описание

**gpt\_description** `string`

Описание(обязательно при custom=false)

**style** `string`

Целевой стиль

**persona\_id** `string`

Персона, взаимоисключается с `custom_model_id`

**max\_mode** `boolean`

Max-тариф

## uploadExtend — загрузка + продление($0.05, Max $0.10)

Загружает аудио и продолжает с метки времени. Всегда в кастомном режиме.

**model** `string` *required*

Фиксированное `"suno"`

**audio\_url** `string` *required*

URL исходного аудио

**continue\_at** `number` *required*

Точка продолжения(сек)

**prompt** `string`

Текст продолжения

**style** `string`

Стиль

**max\_mode** `boolean`

Max-тариф

## Response

**task\_id** `string`

ID задачи для опроса

**status** `string`

`submitted`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.