Create Music Video

POST

/api/v1/mp4/generate

Create a video with visualizations based on your generated music track.

Usage Guide

Use this endpoint to turn your audio tracks into visually appealing videos

Add artist attribution and branding to your music videos

Videos can be shared on social media or embedded in websites

Parameter Details

taskId identifies the original music generation task

audioId specifies which audio track to visualize when multiple variations exist

Optional author and domainName add customized branding to the video

Developer Notes

Generated video files are retained for 14 days

Videos are optimized for social media sharing

Processing time varies based on audio length and server load

Callbacks

onMp4Generated

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Success

Bodyapplication/json

🔴500Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.kie.ai/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": "DJ Electronic",
    "domainName": "music.example.com"
}'

Response Example

200 - 成功示例

{
    "code": 0,
    "msg": "",
    "data": {
        "taskId": ""
    }
}

Music Video Generation Callbacks

Get Music Video Details