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

# Операции с ассетами

> persona вокальная персона, createVoice клонирование, createModel обучение, vox(устар.)

Ассетные операции производят ID upstream-ассетов(`persona_id` / `voice_id` / `model_id`), пригодные для повторного использования.

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

**model** `string` *required*

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

## persona — вокальная персона(\$0.004)

Извлекает персону из существующего трека; полученный `persona_id` используется в `generation` и др.

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

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

**name** `string` *required*

Имя персоны

**describe** `string`

Описание(опционально)

## createVoice — клонирование голоса(\$0.016)

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

URL аудио — **только чистый вокал**; полный микс upstream отклонит

**name** `string`

Имя голоса

## createModel — обучение кастомной модели(\$0.96)

Обучение на 6-24 треках. Полученный `custom_model_id` передаётся в `generation`(при этом опускайте `version` и `persona_id`).

**name** `string` *required*

Имя модели

**audio\_urls** `array` *required*

6-24 публичных URL аудио

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/music/generations/createModel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","name":"my-voice-model","audio_urls":["https://.../a.mp3","https://.../b.mp3","..."]}'
```

## vox — извлечение вокала(\$0.004, устар.)

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

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

**vocal\_start\_s** `number`

Начало вокального фрагмента(сек, опц.)

**vocal\_end\_s** `number`

Конец вокального фрагмента(сек, опц.)

**styles** `string`

Стиль(опционально)

> [!TIP]
>
> Устарело — upstream рекомендует `persona`.

## Response

**task\_id** `string`

ID задачи

**status** `string`

`submitted`


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