获取WAV转换详情

GET https://kieai.erweima.ai/api/v1/wav/record-info

获取WAV格式转换任务的详细信息。

使用指南

使用此接口检查WAV转换任务的状态
转换完成后访问WAV文件URL
跟踪转换进度和可能发生的任何错误

状态说明

PENDING: 任务等待处理中
SUCCESS: WAV转换成功完成
CREATE_TASK_FAILED: 创建转换任务失败
GENERATE_WAV_FAILED: WAV文件生成过程中失败
CALLBACK_EXCEPTION: 回调过程中发生错误

开发者注意事项

WAV文件URL仅在状态为SUCCESS时在响应中可用
对于失败的任务提供错误代码和消息
成功转换后，WAV文件保留14天

Request

Query Parameters

taskId stringrequired

要获取的WAV转换任务的唯一标识符。这是创建WAV转换任务时返回的taskId。

Example: 988e****c8d3

Responses

请求成功

application/json

Schema
Example (auto)
Example

Schema

codeStatusCode (integer)

响应状态码

Enum Value	Description
200	成功 - 请求已成功处理
401	未授权 - 缺少身份验证凭据或凭据无效
402	积分不足 - 账户没有足够的积分执行此操作
404	未找到 - 请求的资源或端点不存在
409	冲突 - WAV记录已存在
422	参数错误 - 请求参数未通过验证检查
429	超出限制 - 已超过对此资源的请求限制
455	服务不可用 - 系统当前正在进行维护
500	服务器错误 - 在处理请求时发生意外错误
505	功能已禁用 - 请求的功能当前已禁用

Possible values: [200, 401, 402, 404, 409, 422, 429, 455, 500, 505]

msgstring

当 code != 200 时的错误信息

Example: success

data object

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "a97c7671c0bc12d8ffdf67c1777e267b",
    "musicId": "string",
    "callbackUrl": "string",
    "completeTime": "2024-07-29T15:51:28.071Z",
    "response": {
      "audioWavUrl": "string"
    },
    "status": "PENDING",
    "createTime": "2024-07-29T15:51:28.071Z",
    "errorCode": 0,
    "errorMessage": "string"
  }
}

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "988e****c8d3",
    "musicId": "8551****662c",
    "callbackUrl": "https://api.example.com/callback",
    "completeTime": "2025-01-01 00:10:00",
    "response": {
      "audioWavUrl": "https://example.com/s/04e6****e727.wav"
    },
    "status": "SUCCESS",
    "createTime": "2025-01-01 00:00:00",
    "errorCode": null,
    "errorMessage": null
  }
}

Authorization: http

name: BearerAuthtype: httpscheme: bearerbearerFormat: API Keydescription: 所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key:
1. 访问 [API Key 管理页面](https://kie.ai/api-key) 获取您的 API Key

使用方式:
在请求头中添加：
Authorization: Bearer YOUR_API_KEY

注意事项：
- 请妥善保管您的 API Key，不要泄露给他人
- 如果怀疑 API Key 泄露，请立即在管理页面重置

HTTPCLIENT
RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://kieai.erweima.ai/api/v1/wav/record-info");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

ResponseClear

Click the Send API Request button above and see the response here!

获取WAV转换详情

https://kieai.erweima.ai/api/v1/wav/record-info

使用指南​

状态说明​

开发者注意事项​

Request​