文档

API 参考

查询语音克隆状态

GET/v1/audio-clone/tasks/{task_id}/status

按同账户同 Key 查询，仍使用普通 TokenAuth 与 audio-clone-v1 模型限制。

鉴权与权限

使用当前 GloopAPI Key。模型、功能与权限以当前 Key 的目录及接口说明为准。

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

路径参数

  • task_idstring必填

    同 Key 创建的任务公开 ID。

响应与错误

HTTP 200

请求成功。

application/json

类型
object
必填字段
idstatus
  • idstring必填
  • statusstring必填
    枚举
    ["queued","processing","succeeded","failed","cancelled"]

HTTP 401

Key 缺失、无效、过期或已撤销。

application/json

类型
object
必填字段
error

HTTP 403

IP、账户、模型或工具权限不足。

application/json

类型
object
必填字段
error

HTTP 404

对象或能力不可用。

application/json

类型
object
必填字段
error
  • errorobject必填
    error 子字段（3）
    • messagestring必填
    • typestring必填
      枚举
      ["new_api_error"]
    • codestring必填
      枚举
      ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 409

请求冲突、未准备或提交未知，先查询原记录，禁止盲重发。

application/json

类型
object
必填字段
error
  • errorobject必填
    error 子字段（3）
    • messagestring必填
    • typestring必填
      枚举
      ["new_api_error"]
    • codestring必填
      枚举
      ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 429

请求/队列限流。

application/json

类型
object
必填字段
error

HTTP 500

鉴权或数据存储内部失败。

application/json

类型
object
必填字段
error

HTTP 502

服务响应异常。

application/json

类型
object
必填字段
error
  • errorobject必填
    error 子字段（3）
    • messagestring必填
    • typestring必填
      枚举
      ["new_api_error"]
    • codestring必填
      枚举
      ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 503

服务、存储或定价暂不可用。

application/json

类型
object
必填字段
error
  • errorobject必填
    error 子字段（3）
    • messagestring必填
    • typestring必填
      枚举
      ["new_api_error"]
    • codestring必填
      枚举
      ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]