Sign in

v1

latestOpenAPI 3.0.02026-07-26355125.0 KB

Create Music Video

post/api/v1/mp4/generate

Request body

taskIdstring required

The task ID of the music generation task.

  • Required. This identifies the task containing the audio to be converted to video.
  • Both taskId and audioId are needed to identify the exact track.
audioIdstring required

The ID of the specific track to convert to video.

  • Required. This identifies which specific track within the task to convert.
  • Both taskId and audioId are needed to identify the exact track.
callBackUrlstring uri required

The URL to receive video generation completion notification.

  • Required.
  • The callback will include a single downloadable URL for the generated MP4 video.
  • For detailed callback format and implementation guide, see Music Video Generation Callbacks
  • Alternatively, you can use the get music video details endpoint to poll task status
authorstring

The artist or creator name to display on the video.

  • Optional.
  • Will be shown prominently in the video, typically at the beginning.
  • Maximum 50 characters.
domainNamestring

The website or brand to display as watermark.

  • Optional.
  • Will appear as a subtle watermark at the bottom of the video.
  • Maximum 50 characters.

Example request

{
  "taskId": "taskId_774b9aa0422f",
  "audioId": "e231****-****-****-****-****8cadc7dc",
  "callBackUrl": "https://api.example.com/callback",
  "author": "Suno Artist",
  "domainName": "music.example.com"
}

Response

Request successful

code200 | 400 | 401 | 404 | 405 | 409 | 413 | 429 | 430 | 455 | 500

Status Codes

  • ✅ 200 - Request successful
  • ⚠️ 400 - Invalid parameters
  • ⚠️ 401 - Unauthorized access
  • ⚠️ 404 - Invalid request method or path
  • ⚠️ 405 - Rate limit exceeded
  • ⚠️ 409 - Conflict - Mp4 record already exists
  • ⚠️ 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
msgstring

Error message when code != 200

Example response

{
  "msg": "success",
  "data": {
    "taskId": "taskId_774b9aa0422f"
  }
}