> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apistable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice 与 Persona 流程

> 录音、验证、创建和复用歌唱音色。

> 能力按服务端配置逐项启用。未启用操作返回 503 且不创建任务；音乐积分扣除当前未启用。

## 录音 Voice：四步

* 1. 提交 suno\_voice\_upload，传 voice\_url 和 vocal\_start\_s/vocal\_end\_s，等待 ready:true。
* 2. POST /api/v1/voices/verification\_phrase，传 voice\_upload\_task\_id 和 language。此步骤选择验证短句语言，实际验证发生在第 3 步；再次调用可重取短句。
* 3. 本人朗读 phrase\_text 并上传录音，以同一上传任务 ID、phrase\_id 和 upload\_url 提交 suno\_voice\_create，通过统一任务查询获得 voice\_id。
* 4. GET /api/v1/voices/\{voice\_id} 检查当前可用性；供应商查询故障返回 503，不伪造成 available:false。

> 语言：en、zh、es、fr、pt、de、ja、ko、hi、ru，默认en。样本会话自成功准备后有效24小时，短句映射继承相同到期时间。expires\_at:null仅表示供应商短句TTL未知，不代表永久有效；仅短句过期时重取短句，样本会话过期后须重新上传样本并从头验证。

## 复用已验证音色

生成音乐时将返回的voice\_id作为persona\_id，并传persona\_model=voice\_persona。上传时的name/description不会自动继承，请在suno\_voice\_create中填写最终名称和描述。

```json theme={null}
{
  "model": "suno_generate",
  "input": {
    "model": "V6",
    "custom_mode": true,
    "instrumental": false,
    "title": "Paper boats at dawn",
    "style": "Fingerpicked guitar, gentle brushed drums",
    "lyrics": "[Verse]\nWe fold a map into a boat\nAnd let the morning carry it home",
    "persona_id": "YOUR_VOICE_ID",
    "persona_model": "voice_persona"
  }
}
```

## 从歌曲创建

风格 Persona：suno\_persona\_create 传 persona\_model=style\_persona 和 audio\_id。声音 Persona：先 suno\_persona\_prepare，再在去除静音后的人声时间轴选取 10–30 秒，提交 persona\_model=voice\_persona 和 prepared\_audio\_id。供应商拒绝可选波形提取时 waveform 为 null，已准备的人声音频仍可使用。上传音频及其翻唱/续写衍生作品不能创建歌曲 Persona。


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