Skip to main content
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": 1735661400000,
    "response": {
      "videoUrl": "https://example.com/videos/video_847715e66259.mp4"
    },
    "successFlag": "SUCCESS",
    "createTime": 1735661400000,
    "errorCode": null,
    "errorMessage": null
  }
}
Retrieve the full state of a music video generation task — including status, timestamps, and the final MP4 download URL — using the taskId you received from Create Music Video.

​
What you get

  • Task Metadata: taskId, musicId, musicIndex, createTime, completeTime
  • Result Payload: response.videoUrl (direct link to the generated MP4)
  • Status: successFlag = PENDING | SUCCESS | failure states with errorMessage when applicable

​
Required Query Parameter

​
taskId (string)

The identifier returned by POST /api/v1/mp4/generate. Use it to fetch progress and (when ready) the video URL.

​
Success Response (example)

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "taskId_774b9aa0422f",
    "musicId": "audioId_0295980ec02e",
    "callbackUrl": "https://api.example.com/callback",
    "musicIndex": 0,
    "completeTime": 1735661400000,
    "response": {
      "videoUrl": "https://example.com/videos/video_847715e66259.mp4"
    },
    "successFlag": "SUCCESS",
    "createTime": 1735661400000,
    "errorCode": null,
    "errorMessage": null
  }
}

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

Request successful

​
code
enum<integer>

Status code. 200 - Request successful, 400 - Invalid parameters, 401 - Unauthorized access, 404 - Invalid request method or path, 405 - Rate limit exceeded, 413 - Theme or prompt too long, 429 - Insufficient credits, 430 - Your call frequency is too high. Please try again later, 455 - System maintenance, 500 - Server error

Available options:
200,
400,
401,
404,
405,
413,
429,
430,
455,
500
Example:

200

​
msg
string

Error message when code != 200

Example:

"success"

​
data
object