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

# Текст / Inspo / Эффекты / Теги

> lyrics генерация текста, inspo по референсам, sounds эффекты, upsampleTags расширение

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

<ParamField body="model" type="string" required>Фиксированное `"suno"`</ParamField>

## lyrics — генерация текста(\$0.008)

<ParamField body="prompt" type="string" required>Тема или описание текста</ParamField>
<ParamField body="lyrics_model" type="string">Модель текста:`classic` / `remi`(опционально)</ParamField>

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/music/generations/lyrics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","prompt":"песня про лето у моря"}'
```

## inspo — генерация по референсам($0.068, Max $0.136)

Новый трек, вдохновлённый 1-4 референсами.

<ParamField body="audio_urls" type="array" required>1-4 публичных URL аудио</ParamField>
<ParamField body="max_mode" type="boolean">Max-тариф(поля `custom` нет, применяется сразу)</ParamField>

<Warning>Не отправляйте `custom` — upstream отклонит.</Warning>

## sounds — звуковые эффекты(\$0.0096)

<ParamField body="prompt" type="string" required>Описание эффекта</ParamField>
<ParamField body="type" type="string">Тип эффекта</ParamField>
<ParamField body="bpm" type="number">Темп(диапазон 1-300)</ParamField>
<ParamField body="key" type="string">Тональность</ParamField>

## upsampleTags — расширение тегов(\$0.004)

Разворачивает краткий тег стиля в подробное описание.

<ParamField body="tags" type="string" required>Теги стиля, например `"lo-fi chill beats"`</ParamField>

## Response

<ResponseField name="task_id" type="string">ID задачи</ResponseField>
<ResponseField name="status" type="string">`submitted`</ResponseField>


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