> ## 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(`persona_id` / `voice_id` / `model_id`)を生成します。

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

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

## persona — ボーカルペルソナ(\$0.004)

既存曲からペルソナを抽出し、生成される `persona_id` を `generation` 等で再利用。

<ParamField body="task_id" type="string" required>元タスク ID</ParamField>
<ParamField body="name" type="string" required>ペルソナ名</ParamField>
<ParamField body="describe" type="string">説明(任意)</ParamField>

## createVoice — 音声クローン(\$0.016)

<ParamField body="audio_url" type="string" required>元音声 URL。<b>クリーンなボーカルトラックのみ</b>。フルミックスは上流で拒否されます</ParamField>
<ParamField body="name" type="string">ボイス名</ParamField>

## createModel — カスタムモデル学習(\$0.96)

6-24 トラックでカスタムモデルを学習。生成される `custom_model_id` を `generation` に指定(カスタムモデル使用時は `version`/`persona_id` を省略)。

<ParamField body="name" type="string" required>モデル名</ParamField>
<ParamField body="audio_urls" type="array" required>公開音声 URL を 6-24 件</ParamField>

```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,旧版)

<ParamField body="task_id" type="string" required>元タスク ID</ParamField>
<ParamField body="vocal_start_s" type="number">ボーカル区間開始(秒,任意)</ParamField>
<ParamField body="vocal_end_s" type="number">ボーカル区間終了(秒,任意)</ParamField>
<ParamField body="styles" type="string">スタイル(任意)</ParamField>

<Tip>非推奨。上流は `persona` を推奨。</Tip>

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