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

# 总览

> 片段 Persona vs Voice Persona — Clone Voice（收费）或 Init + Complete（免费）

# Persona

> 两个家族。**Clone Voice** 和 **Init + Complete** 都是 **Voice Persona** — 产物相同，计费不同。

Persona 是传给 `/generate` 的可复用人声身份。不要把片段 Persona 和 Voice Persona 混用。

## 片段 Persona

从已有 Suno clip 抽出风格 / 人声色彩。**已脱敏** — 任意账号可用。

<CardGroup cols={2}>
  <Card title="创建片段 Persona" icon="user" href="/zh/api-reference/suno/persona">
    用 `clip_id` 同步创建。不绑声纹。`/generate` 保持 `is_voice: false`。
  </Card>

  <Card title="提取人声" icon="waveform" href="/zh/api-reference/suno/getVoxStem">
    抽出人声后，把 `vox_audio_id` 传给片段 Persona（`persona_type: "vox"`）。
  </Card>
</CardGroup>

## Voice Persona

真人音色克隆，**声纹绑定**创建账号。两套接口，**同一种 Voice Persona**：

<CardGroup cols={2}>
  <Card title="Clone Voice" icon="clone" href="/zh/api-reference/suno/voices">
    `POST /suno/v2/voices` — 一条 `audio_url`、一次任务。**收费。** 短语仅英语。
  </Card>

  <Card title="Init + Complete" icon="list-check" href="/zh/api-reference/suno/voicePersona">
    用户朗读 `phrase_text`。**免费。** 多语言。产物与 Clone Voice 相同。
  </Card>
</CardGroup>

```
 Clone Voice  /voices     （收费，1 次请求）
      └─ 同一套流程 ──►  init  +  complete   （免费，2 次请求）
                                    │
                                    ▼
                              Voice Persona
                              is_voice: true
```

|                | Clone Voice `/voices`             | Init → Complete               |
| -------------- | --------------------------------- | ----------------------------- |
| **家族**         | Voice Persona                     | Voice Persona                 |
| **产物**         | `{ name, is_public, persona_id }` | 同一种 Voice Persona             |
| **计费**         | **收费**（失败不应扣费）                    | **免费**                        |
| **输入**         | 公网 `audio_url`                    | 原声音频 + 当场朗读                   |
| **前端**         | 不用短语、不用二次录音                       | 展示 `phrase_text`，约 30 秒内录完    |
| **短语语言**       | 仅英语                               | `zh` / `en` / `ja` / `ko` / … |
| **`is_voice`** | `true`                            | `true`                        |
| **账号**         | 仅创建账号                             | 仅创建账号                         |

<Tip>
  只有 URL、没有朗读界面 → **Clone Voice（收费）**。用户能朗读 → **Init + Complete（免费）**。两边拿到的都是 Voice Persona 的 `persona_id`。
</Tip>

### Clone Voice 任务结果

轮询 `/suno/v2/status` 到 `success` 后，`data` 如下：

```json theme={null}
{
  "name": "voices-ext-fix-verify",
  "is_public": false,
  "persona_id": "af88153e-a513-432a-a9b5-3948fb562d4b"
}
```

`/generate` 使用 `persona_id`，并设 `is_voice: true`。

## 脱敏 vs 声纹绑定

|                | 片段 Persona                   | Voice Persona（Clone Voice **或** Init+Complete） |
| -------------- | ---------------------------- | ---------------------------------------------- |
| **是否脱敏**       | **是**                        | **否** — 声纹绑定                                   |
| **谁能用**        | 任意账号                         | **必须同一** Suno 账号                               |
| **`is_voice`** | `false`                      | `true`                                         |
| **输入**         | `clip_id`（可选 `vox_audio_id`） | 真人录音                                           |

<Warning>
  Voice Persona 若传 `is_voice: false`，或换账号，会失败。片段 Persona **不要**设 `is_voice: true`。
</Warning>

## 在 `/generate` 里使用

```json theme={null}
{
  "task": "create",
  "model": "chirp-v55",
  "prompt": "[Verse]\n...",
  "persona": {
    "persona_id": "af88153e-a513-432a-a9b5-3948fb562d4b",
    "artist_clip_id": "clip_abc123",
    "persona_style": "vox",
    "is_voice": true
  }
}
```

| 字段               | 必填 | 说明                                           |
| ---------------- | -- | -------------------------------------------- |
| `persona_id`     | 是  | 片段创建，或 Clone Voice / Init+Complete 轮询 `data` |
| `artist_clip_id` | 是  | 风格参考 clip（常用 persona 的 `root_clip_id`）       |
| `persona_style`  | 否  | chirp-v50+ 仅 `"vox"`                         |
| `is_voice`       | 否  | **仅 Voice Persona** 为 `true`                 |