Skip to main content
GET
获取恢复音频详情
查询由恢复音频接口创建的恢复任务,读取恢复出的音频链接。

状态说明

  • 201 — 恢复任务进行中,请继续轮询
  • 200 — 恢复完成,且至少有一首音轨恢复成功
  • 500 — 所有音轨均恢复失败

单条记录的 status

  • successaudio_url 为恢复出的可播放链接
  • failedaudio_url 为空,error 说明失败原因
常见的 error 取值:

开发者提示

  • 无法提供公网回调地址时请轮询本接口,建议轮询间隔 2 秒。
  • code201datanull
  • 恢复出的 audio_url 可能是 .m4a 文件,保存时不要固定按 .mp3 处理。

授权

Authorization
string
header
必填

🔑 API 认证说明

所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key

  1. 访问 API Key 管理页面 获取您的 API Key

使用方式

在请求头中添加:

⚠️ 注意:

  • 请妥善保管您的 API Key,不要泄露给他人
  • 如果怀疑 API Key 泄露,请立即在管理页面重置

查询参数

task_id
string
必填

「恢复音频」接口返回的恢复任务 ID。

响应

请求成功

code
enum<integer>

状态码说明

  • ✅ 200 - 恢复完成,至少有一首音频恢复成功
  • ⏳ 201 - 恢复任务进行中,请继续轮询
  • ⚠️ 400 - 参数错误
  • ⚠️ 401 - 没有访问权限
  • ⚠️ 404 - 请求方式或者路径错误
  • ⚠️ 405 - 调用超过限制
  • ⚠️ 429 - 积分不足
  • ⚠️ 430 - 您的调用频率过高。请稍后再试。
  • ⚠️ 455 - 网站维护
  • ❌ 500 - 恢复任务失败或服务器异常
可用选项:
200,
201,
400,
401,
404,
405,
429,
430,
455,
500
示例:

200

task_id
string

恢复任务 ID。

示例:

"bbbb****0f7b"

msg
string

结果描述

示例:

"success"

data
object[] | null

每首音轨的恢复结果,任务进行中时返回 null