获取音乐生成详情

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

获取音乐生成任务的详细信息，包括状态、参数和结果。

状态说明

PENDING: 任务正在等待处理
TEXT_SUCCESS: 歌词/文本生成已成功完成
FIRST_SUCCESS: 第一首曲目生成已成功完成
SUCCESS: 所有曲目已成功生成
CREATE_TASK_FAILED: 创建生成任务失败
GENERATE_AUDIO_FAILED: 生成音乐曲目失败
CALLBACK_EXCEPTION: 回调过程中发生错误
SENSITIVE_WORD_ERROR: 内容包含禁用词

开发者注意事项

对于纯音乐曲目（instrumental=true），响应中不会包含歌词数据
可以使用此接口检查任务状态，而不必等待回调

Request

Query Parameters

taskId stringrequired

从'生成音乐'或'延长音乐'接口返回的任务ID。用于标识要查询的特定生成任务。

Example: 5c79****be8e

Responses

请求成功

application/json

Schema
Example (auto)
Example

Schema

codeinteger

状态码说明

✅ 200 - 请求成功
⚠️ 400 - 参数错误
⚠️ 401 - 没有访问权限
⚠️ 404 - 请求方式或者路径错误
⚠️ 405 - 调用超过限制
⚠️ 413 - 主题或者prompt过长
⚠️ 429 - 积分不足
⚠️ 455 - 网站维护
❌ 500 - 服务器异常

Possible values: [200, 400, 401, 404, 405, 413, 429, 455, 500]

Example: 200

msgstring

当 code != 200 时，展示错误信息

Example: success

data object

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "string",
    "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: # 🔑 API 认证说明

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

## 获取 API Key

1. 访问 [API Key 管理页面](https://sunoapi.org/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://apibox.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://apibox.erweima.ai/api/v1/generate/record-info

状态说明​

开发者注意事项​

Request​