> ## 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}
```

**model** `string` *required*

固定 `"suno"`

## persona — 人聲角色(\$0.004)

從已有歌曲提取人聲角色,產出 `persona_id` 供 `generation` 等操作複用。

**task\_id** `string` *required*

源任務 ID

**name** `string` *required*

角色名稱

**describe** `string`

角色描述(可選)

## createVoice — 克隆聲音(\$0.016)

**audio\_url** `string` *required*

源音訊 URL,**需乾淨的人聲片段**,混音成品會被上游拒絕

**name** `string`

聲音名稱

## createModel — 自訂模型訓練(\$0.96)

用 6-24 條音訊訓練自訂模型,產出 `custom_model_id`,後續 `generation` 傳該 ID 即可使用(使用自訂模型時需省略 `version` 與 `persona_id`)。

**name** `string` *required*

模型名稱

**audio\_urls** `array` *required*

6-24 條公網音訊 URL

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

**task\_id** `string` *required*

源任務 ID

**vocal\_start\_s** `number`

人聲段起點(秒,可選)

**vocal\_end\_s** `number`

人聲段終點(秒,可選)

**styles** `string`

風格(可選)

> [!TIP]
>
> 已廢棄,上游建議使用 `persona`。

## Response

**task\_id** `string`

任務 ID

**status** `string`

`submitted`


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