> ## 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 効果音、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>公開音声 URL を 1-4 件</ParamField>
<ParamField body="max_mode" type="boolean">Max ティア(本操作に `custom` なし。直接有効)</ParamField>

<Warning>`custom` は送信しないでください。上流で拒否されます。</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.