---
title: "Create Music Video"
method: POST
path: "/api/v1/mp4/generate"
---

# Create Music Video

`POST /api/v1/mp4/generate`

## Request body

- object
  - `taskId` string, 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.
  - `audioId` string, 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.
  - `callBackUrl` string, 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](https://docs.sunoapi.org/suno-api/create-music-video-callbacks) - Alternatively, you can use the get music video details endpoint to poll task status
  - `author` string — 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.
  - `domainName` string — The website or brand to display as watermark. - Optional. - Will appear as a subtle watermark at the bottom of the video. - Maximum 50 characters.

## Response `200`

Request successful

- object
  - `code` 200 | 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
  - `msg` string — Error message when code != 200
  - `data` object
    - `taskId` string — Task ID for tracking task status

## Other responses

- `500` — Server error

---

[API](https://skmtc.net/sunoapi/apis/file-upload-api.md) · [All operations](https://skmtc.net/sunoapi/apis/file-upload-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sunoapi/file-upload-api/versions/22d45ee33a4a/schema)