Skip to main content
POST
同步人声分离

说明

同步方式进行人声分离。请求需要上传音频文件,并在 HTTP 连接中等待处理完成。处理成功后,接口会直接返回分离后的人声音频 URL。 对于不需要持续保持 HTTP 连接、希望先获取任务 ID 再查询结果的场景,见异步人声分离 API

音频要求

  • 上传字段固定为 file
  • 支持的音频格式、时长与文件大小限制以服务端校验规则为准
  • 当文件不符合模型要求或音频格式非法时,服务端将返回 400
在线 Playground 会先通过文档站代理上传文件,较大的音视频文件可能触发 413 Request Entity Too Large。如需测试较大文件,请使用下方 curl 示例或 SDK 从本地直连 https://api.senseaudio.cn

请求示例

授权

Authorization
string
header
必填

格式:Bearer <API_KEY>

请求体

multipart/form-data
model
enum<string>
必填

人声分离模型名称

可用选项:
senseaudio-voice-isolation-1.0-260319,
senseaudio-voice-isolation-1.5
示例:

"senseaudio-voice-isolation-1.0-260319"

file
file
必填

待处理的音频文件

响应

人声分离成功

source_file_name
string
必填

原始上传文件名

示例:

"sample.wav"

result_url
string
必填

分离结果音频 URL。任务成功时返回;任务处理中或失败时可能为空字符串。

示例:

"https://xxx/voice-isolation/result.mp3"

status
enum<string>
必填

任务状态

可用选项:
pending,
completed,
failed
error_message
string
必填

错误信息。任务失败时返回失败原因,任务成功或处理中时通常为空字符串。

示例:

""