跳到主要内容

歌曲精准转录

接口说明​

提交音频的 Base64 数据并等待结果返回。费用 $0.008 美元一次。

Base URL:

https://api.foxaihub.com/api/v2

请求​

POST /transcribe/task/wait
Content-Type: application/json
api-key: YOUR_API_KEY

请求体：

{
  "audio_base64": "data:audio/mp3;base64,AAA..."
}

字段说明：

字段类型必填说明
audio_base64string是音频文件的 Base64 Data URL，推荐格式为 data:audio/mp3;base64,...

输出结果​

1. 转录成功​

HTTP 状态码：

200 OK

响应体：

{
  "id": 123,
  "task_id": "a42e2c77-ded8-48aa-8aa4-dfd9daa43801",
  "audio_url": "https://cdn2.foxai.me/transcribe/a42e2c77-ded8-48aa-8aa4-dfd9daa43801.mp3",
  "status": "completed",
  "data": {},
  "created_time": "2026-03-02T10:00:00.000Z",
  "update_time": "2026-03-02T10:00:12.000Z"
}

含义：

  • status = completed 表示任务已完成
  • data 中包含转录结果

2. 转录失败​

HTTP 状态码：

200 OK

响应体：

{
  "id": 123,
  "task_id": "a42e2c77-ded8-48aa-8aa4-dfd9daa43801",
  "audio_url": "https://cdn2.foxai.me/transcribe/a42e2c77-ded8-48aa-8aa4-dfd9daa43801.mp3",
  "status": "failed",
  "data": {
    "message": "transcribe failed"
  },
  "created_time": "2026-03-02T10:00:00.000Z",
  "update_time": "2026-03-02T10:00:12.000Z"
}

含义：

  • status = failed 表示任务已结束，但处理失败
  • data 中通常包含失败原因或错误信息

3. 等待超时​

HTTP 状态码：

408 Request Timeout

响应体：

{
  "task_id": "a42e2c77-ded8-48aa-8aa4-dfd9daa43801",
  "status": "processing",
  "message": "Task wait timeout after 30000ms"
}

含义：

  • 请求等待超时，但任务已经创建成功
  • task_id 可用于后续继续查询任务结果
  • status 表示超时返回时任务的最新状态，通常是 pending 或 processing

错误响应​

认证失败​

{
  "message": "Unauthorized"
}

余额不足或创建任务失败​

{
  "error": "Insufficient balance"
}

服务端轮询异常​

{
  "error": "Music transcribe task not found: xxx"
}

cURL 示例​

curl -X POST "https://api.foxaihub.com/api/v2/transcribe/task/wait" \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_API_KEY" \
  -d '{
    "audio_base64": "data:audio/mp3;base64,AAA..."
  }'