GET
/
api
/
v1
/
mp4
/
record-info
Get Music Video Details
curl --request GET \
  --url https://api.sunoapi.org/api/v1/mp4/record-info \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "taskId_774b9aa0422f",
    "musicId": "audioId_0295980ec02e",
    "callbackUrl": "https://api.example.com/callback",
    "musicIndex": 0,
    "completeTime": "2025-01-01 00:10:00",
    "response": {
      "videoUrl": "https://example.com/videos/video_847715e66259.mp4"
    },
    "successFlag": "SUCCESS",
    "createTime": "2025-01-01 00:00:00",
    "errorCode": null,
    "errorMessage": null
  }
}

​
Status Descriptions

  • PENDING: Task is waiting to be processed
  • SUCCESS: Video generation completed successfully
  • CREATE_TASK_FAILED: Failed to create the video task
  • GENERATE_MP4_FAILED: MP4 generation failed
  • CALLBACK_EXCEPTION: Callback exception

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 Create Music Video endpoint. Used to retrieve detailed information about the video generation task, including processing status and download URL.

Response

200
application/json

Request successful

The response is of type object.