Generate Luma Modify Video

POST

/api/v1/modify/generate

Create a new Luma video modification generation task.

Important Notes

Generated videos will be processed asynchronously

Use the returned taskId to track generation progress

It is recommended to use callback URLs in production environments to receive automatic notifications when generation is complete

Original video URLs must be publicly accessible

Watermark parameters are optional and used for branding purposes

Video Requirements

Supported Formats: MP4, MOV, AVI\

Maximum File Size: 500MB\

Maximum Duration: 10 seconds\

Accessibility: Video URLs must be publicly accessible

Processing Time

Video modification is a computationally intensive process, typically requiring:

Simple Modifications: 2-5 minutes

Complex Transformations: 5-15 minutes

High-Resolution Videos: 10-20 minutes

Use callback mechanisms or polling to track progress instead of synchronous waiting.

Callbacks

onVideoGenerated

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

Request successful

Body

🔴500Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.kie.ai/api/v1/modify/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "A futuristic cityscape at night with towering glass spires reaching into a starry sky",
    "videoUrl": "https://example.com/input-video.mp4",
    "callBackUrl": "https://your-callback-url.com/luma-callback",
    "watermark": "your-watermark-id"
}'

Response Example

200 - Successful Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "774d9a7dd608a0e49293903095e45a4c"
    }
}

Luma Modify Video Callbacks

Get Luma Modify Details

Generate Luma Modify Video

Important Notes#

Processing Time#

Callbacks

onVideoGenerated

Request

Responses

Important Notes

Processing Time