> ## 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` 傳該 ID 即可使用(使用自訂模型時需省略 `version` 與 `persona_id`)。

<ParamField body="name" type="string" required>模型名稱</ParamField>
<ParamField body="audio_urls" type="array" required>6-24 條公網音訊 URL</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.