> ## 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 人声提取

> [!NOTE]
>
> **国内用户请注意：** 中国大陆用户请使用 `https://toapis.cn` 作为接口地址（Base URL）。

资产类操作产出可在后续请求中复用的上游资产 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.