跳到主要内容

获取配音项目

GET 
https://api.knoxstudio.ai/v1/dubbing/project/:project_id

获取项目状态和元数据。不计费。状态：queued、preparing、processing、ready、failed。

请求​

路径参数​

名称类型必填描述
project_idString是配音项目 ID。

请求头​

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

cURL 示例​

curl -X GET https://api.knoxstudio.ai/v1/dubbing/project/proj_123 \
     -H "Authorization: Bearer $KNOXCHAT_API_KEY"

响应​

成功响应 (200)​

项目 JSON，在可用时包含 model_id 和 media.duration_s。

错误响应​

校验失败使用 HTTP 422：

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

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

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