API 参考

取得语音克隆结果

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

后台已完成后查询；结果归档状态独立于成功，失败 422，未准备或未知 409。

鉴权与权限

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

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

路径参数

task_idstring必填
同 Key 创建的任务公开 ID。

响应与错误

HTTP 200

请求成功。

application/json

类型: object
必填字段: idstatusresultusage

idstring必填
statusstring必填
枚举
["succeeded"]
resultobject必填
result 子字段（6）
- file_idstring选填
  同账户同 Key 的托管文件公开 ID。
- storage_statusstring选填
  文件归档状态，ready 后才保证托管下载可用。
- audio_urlstring必填
  生成音频访问地址，托管时由存储层提供签名 URL。
- content_typestring选填
  结果 MIME 类型。
- file_namestring选填
  公开下载文件名。
- file_sizeinteger选填
  结果文件字节数。
usageobject必填
usage 子字段（1）
- charactersinteger必填
  最小值
  0

HTTP 401

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

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

HTTP 403

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

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

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 422

生成失败。

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

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

HTTP 500

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

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

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"]