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

# Lyrics / Inspo / Sounds / Tags

> lyrics generation, inspo reference-audio generation, sounds effects, upsampleTags expansion

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

<ParamField body="model" type="string" required>Fixed `"suno"`</ParamField>

## lyrics — lyrics generation (\$0.008)

<ParamField body="prompt" type="string" required>Theme or topic description</ParamField>
<ParamField body="lyrics_model" type="string">Lyrics model: `classic` / `remi` (optional)</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":"a song about summer by the sea"}'
```

## inspo — inspired generation ($0.068, Max $0.136)

Generate a new song inspired by 1-4 reference tracks.

<ParamField body="audio_urls" type="array" required>1-4 public audio URLs</ParamField>
<ParamField body="max_mode" type="boolean">Max tier (no `custom` field; applies directly)</ParamField>

<Warning>Do not send `custom`; the upstream rejects it.</Warning>

## sounds — sound effects (\$0.0096)

<ParamField body="prompt" type="string" required>Effect description</ParamField>
<ParamField body="type" type="string">Effect type</ParamField>
<ParamField body="bpm" type="number">Tempo (range 1-300)</ParamField>
<ParamField body="key" type="string">Musical key</ParamField>

## upsampleTags — tag expansion (\$0.004)

Expand a short style tag into a detailed style description.

<ParamField body="tags" type="string" required>Style tags, e.g. `"lo-fi chill beats"`</ParamField>

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/music/generations/upsampleTags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","tags":"lo-fi chill beats"}'
```

## Response

<ResponseField name="task_id" type="string">Task ID</ResponseField>
<ResponseField name="status" type="string">`submitted`</ResponseField>


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