> ## 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）。
</Note>

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