跳到主要内容

列出人声分离历史

GET 

https://api.knoxstudio.ai/v1/audio-isolation/history

列出过往分离任务。不计费。指南:人声分离。

请求​

查询参数​

名称类型必填描述
page_sizeInteger否返回条数。1–1000,默认 100。
pageInteger否页码,必须 ≥ 1。
searchString否可选搜索字符串,原样转发到上游。

请求头​

名称类型必填描述
AuthorizationString是Bearer <token> Knox API key。也接受 xi-api-key。

cURL 示例​

curl -X GET "https://api.knoxstudio.ai/v1/audio-isolation/history?page_size=100&page=1" \
-H "Authorization: Bearer $KNOXCHAT_API_KEY"

响应​

成功响应 (200)​

上游历史列表。将 history_item_id 用于 删除人声分离历史。

错误响应​

校验失败使用 HTTP 422:

{
"detail": [
{
"loc": ["body", "field"],
"msg": "…",
"type": "value_error"
}
]
}

其他错误使用 { "detail": "message" }。

状态何时
400未升级 WebSocket 就访问 WebSocket 端点。
401缺少或无效的 API key。
402余额不足。
403Token 无权使用该模型。
404资源未找到。
422校验错误。
429超出速率限制。
500服务器内部错误。