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

# 人声分离介绍

> 使用人声分离接口从音频中提取人声轨道

人声分离能力可从上传音频中分离人声轨道，适用于音频后期处理、素材清洗、语音内容分析前处理等场景。

## 接入方式

<CardGroup cols={2}>
  <Card title="同步人声分离" icon="headphones" href="/api-reference/endpoint/voice-isolation/sync">
    上传音频并等待处理完成，接口直接返回分离结果 URL。
  </Card>

  <Card title="异步人声分离" icon="clock" href="/api-reference/endpoint/voice-isolation/async">
    上传音频并创建任务，适合不希望长时间保持 HTTP 连接的场景。
  </Card>

  <Card title="查询任务结果" icon="magnifying-glass" href="/api-reference/endpoint/voice-isolation/pending">
    使用 `task_id` 查询任务状态，并在完成后获取 `result_url`。
  </Card>
</CardGroup>

## 推荐流程

1. 对于短音频或需要直接拿到结果的场景，调用[同步人声分离](/api-reference/endpoint/voice-isolation/sync)。
2. 对于耗时较长或需要后台处理的场景，调用[异步人声分离](/api-reference/endpoint/voice-isolation/async)创建任务。
3. 异步任务创建成功后，使用[查询人声分离任务](/api-reference/endpoint/voice-isolation/pending)轮询任务状态。

## 模型

| 模型 ID                                   | 说明     |
| --------------------------------------- | ------ |
| `senseaudio-voice-isolation-1.0-260319` | 人声分离模型 |
| `senseaudio-voice-isolation-1.5`        | 人声分离模型 |

## 音频要求

* 上传字段固定为 `file`
* 支持的音频格式、时长与文件大小限制以服务端校验规则为准
* 当文件不符合模型要求或音频格式非法时，服务端将返回 `400`