GET
/
api
/
v1
/
generate
/
record-info
Get Music Generation Details
curl --request GET \
  --url https://api.sunoapi.org/api/v1/generate/record-info \
  --header 'Authorization: Bearer <token>'
{
  "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
  }
}

​
Status Descriptions

  • PENDING: Task is waiting to be processed
  • TEXT_SUCCESS: Lyrics/text generation completed successfully
  • FIRST_SUCCESS: First track generation completed successfully
  • SUCCESS: All tracks generated successfully
  • CREATE_TASK_FAILED: Failed to create the generation task
  • GENERATE_AUDIO_FAILED: Failed to generate music tracks
  • CALLBACK_EXCEPTION: Error occurred during callback
  • SENSITIVE_WORD_ERROR: Content contains prohibited words

​
Developer Notes

  • For instrumental tracks (instrumental=true), no lyrics data will be included in the response
  • Use this endpoint to check task status instead of waiting for callbacks

Authorizations

​
Authorization
string
header
required

🔑 API Authentication

All endpoints require authentication using Bearer Token.

Get API Key

  1. Visit the API Key Management Page to obtain your API Key

Usage

Add to request headers:

Authorization: Bearer YOUR_API_KEY

⚠️ Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately from the management page

Query Parameters

​
taskId
string
required

The task ID returned from the Generate Music or Extend Music endpoints. Used to identify the specific generation task to query.

Response

Request successful

The response is of type object.