POST
/
api
/
v1
/
mp4
/
generate
Create Music Video
curl --request POST \
  --url https://api.sunoapi.org/api/v1/mp4/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "taskId": "taskId_774b9aa0422f",
  "audioId": "e231****-****-****-****-****8cadc7dc",
  "callBackUrl": "https://api.example.com/callback",
  "author": "Suno Artist",
  "domainName": "music.example.com"
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "taskId_774b9aa0422f"
  }
}

​
Usage Guide

  • This endpoint creates a visual representation of your music track as an MP4 video
  • Both taskId and audioId are required to identify the specific track
  • Optional author and domainName parameters can be used to add branding

​
Developer Notes

  1. Generated video files are retained for 15 days
  2. Videos include visual effects synchronized with the music
  3. This feature is ideal for social media sharing, music promotion, or creating visual content
  4. Videos maintain the same audio quality as the original track

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

Body

application/json

Response

Request successful

The response is of type object.