获取音乐任务详情

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

获取音乐生成任务的详细信息。

使用指南

使用此接口检查任务状态并访问生成结果
任务详情包括状态、参数和生成的曲目
生成的曲目可通过返回的URL访问

状态说明

PENDING: 任务等待处理中
TEXT_SUCCESS: 歌词/文本生成成功
FIRST_SUCCESS: 第一个音轨生成完成
SUCCESS: 所有音轨生成成功
CREATE_TASK_FAILED: 创建任务失败
GENERATE_AUDIO_FAILED: 音频生成失败
CALLBACK_EXCEPTION: 回调过程中出错
SENSITIVE_WORD_ERROR: 内容因敏感词被过滤

开发者注意事项

对于纯音乐曲目（instrumental=true），响应中不会包含歌词数据
最大查询频率：每个任务每秒最多3次请求
响应包括音频文件、图片和流式端点的直接URL

Request

Query Parameters

taskId stringrequired

要获取的音乐生成任务的唯一标识符。可以是"生成音乐"任务或"延长音乐"任务返回的taskId。

Example: 5c79****be8e

Responses

请求成功

application/json

Schema
Example (auto)
Example

Schema

codeStatusCode (integer)

响应状态码

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

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

msgstring

当 code != 200 时的错误信息

Example: success

data object

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5c79****be8e",
    "parentMusicId": "string",
    "param": "string",
    "response": {
      "taskId": "string",
      "sunoData": [
        {
          "id": "string",
          "audioUrl": "string",
          "streamAudioUrl": "string",
          "imageUrl": "string",
          "prompt": "string",
          "modelName": "string",
          "title": "string",
          "tags": "string",
          "createTime": "2024-07-29T15:51:28.071Z",
          "duration": 0
        }
      ]
    },
    "status": "PENDING",
    "type": "chirp-v3-5",
    "operationType": "generate",
    "errorCode": 0,
    "errorMessage": "string"
  }
}

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5c79****be8e",
    "parentMusicId": "",
    "param": "{\"prompt\":\"A calm piano track\",\"style\":\"Classical\",\"title\":\"Peaceful Piano\",\"customMode\":true,\"instrumental\":true,\"model\":\"V3_5\"}",
    "response": {
      "taskId": "5c79****be8e",
      "sunoData": [
        {
          "id": "8551****662c",
          "audioUrl": "https://example.cn/****.mp3",
          "streamAudioUrl": "https://example.cn/****",
          "imageUrl": "https://example.cn/****.jpeg",
          "prompt": "[Verse] 夜晚城市 灯火辉煌",
          "modelName": "chirp-v3-5",
          "title": "钢铁侠",
          "tags": "electrifying, rock",
          "createTime": "2025-01-01 00:00:00",
          "duration": 198.44
        }
      ]
    },
    "status": "SUCCESS",
    "type": "GENERATE",
    "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/generate/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!

获取音乐任务详情

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

使用指南​

状态说明​

开发者注意事项​

Request​