Edit a video with Kling 4.0 Omni Video (the input is the base video)
The client provides a convenient way to interact with the model API.
npm install --save @fal-ai/clientSet FAL_KEY as an environment variable in your runtime.
export FAL_KEY="YOUR_API_KEY"The client API handles the API submit protocol. It will handle the request status updates and return the result when the request is completed.
import { fal } from "@fal-ai/client";
const result = await fal.subscribe("kling/v4/video-to-video/edit", {
input: {
prompt: "Change the background to a tropical island at sunset.",
video_url: ""
},
logs: true,
onQueueUpdate: (update) => {
if (update.status === "IN_PROGRESS") {
update.logs.map((log) => log.message).forEach(console.log);
}
},
});
console.log(result.data);
console.log(result.requestId);The API uses an API Key for authentication. It is recommended you set the FAL_KEY environment variable in your runtime when possible.
import { fal } from "@fal-ai/client";
fal.config({
credentials: "YOUR_FAL_KEY"
});The client API provides a convenient way to submit requests to the model.
import { fal } from "@fal-ai/client";
const { request_id } = await fal.queue.submit("kling/v4/video-to-video/edit", {
input: {
prompt: "Change the background to a tropical island at sunset.",
video_url: ""
},
webhookUrl: "https://optional.webhook.url/for/results",
});You can fetch the status of a request to check if it is completed or still in progress.
import { fal } from "@fal-ai/client";
const status = await fal.queue.status("kling/v4/video-to-video/edit", {
requestId: "764cabcf-b745-4b3e-ae38-1200304cf45b",
logs: true,
});Once the request is completed, you can fetch the result. See the Output Schema for the expected result format.
import { fal } from "@fal-ai/client";
const result = await fal.queue.result("kling/v4/video-to-video/edit", {
requestId: "764cabcf-b745-4b3e-ae38-1200304cf45b"
});
console.log(result.data);
console.log(result.requestId);Some attributes in the API accept file URLs as input. Whenever that's the case you can pass your own URL or a Base64 data URI.
You can pass a Base64 data URI as a file input. The API will handle the file decoding for you. Keep in mind that for large files, this alternative although convenient can impact the request performance.
You can also pass your own URLs as long as they are publicly accessible. Be aware that some hosts might block cross-site requests, rate-limit, or consider the request as a bot.
We provide a convenient file storage that allows you to upload files and use them in your requests. You can upload files using the client API and use the returned URL in your requests.
import { fal } from "@fal-ai/client";
const file = new File(["Hello, World!"], "hello.txt", { type: "text/plain" });
const url = await fal.storage.upload(file);Read more about file handling in our file upload guide.
prompt string* requiredEdit instruction. Reference the source video as @Video1.
video_url string* requiredThe video to edit (3-30s), referenced as @Video1.
Max file size: 300.0MB, Min width: 700px, Min height: 700px, Max width: 4553px, Max height: 4553px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Min duration: 3.0s, Max duration: 30.05s, Min FPS: 23.9, Max FPS: 60.05, Timeout: 30.0s
Reference images, referenced as @Image1, @Image2, ...
Reference videos, referenced as @Video2, @Video3, ... (max 4). The source, reference and element videos must total at most 30s.
Characters/objects, referenced as @Element1, @Element2, ... (max 7). Up to 3 elements may carry a voice_id and up to 3 may be video elements.
Voices referenced in the prompt as @Voice1, @Voice2, ... (max 3, including voices bound to elements). Create one with https://fal.ai/models/fal-ai/kling-video/create-voice
start_image_url stringOptional image to use as the first frame. Counts toward the image reference limit.
Optional ordered keyframes between the first and last frames (max 8). Count toward the image reference limit.
end_image_url stringOptional image to use as the last frame. Counts toward the image reference limit.
duration integerOutput duration in seconds (3-30). Defaults to the source video's length.
resolution ResolutionEnumOutput resolution. Default value: "1080p"
Possible enum values: 720p, 1080p
aspect_ratio EnumAspect ratio of the edited video. 'auto' adapts it to the inputs. Omit to follow the source video.
Possible enum values: auto, 16:9, 9:16, 1:1, 21:9
{
"prompt": "Change the background to a tropical island at sunset.",
"video_url": "",
"image_urls": null,
"video_urls": null,
"elements": null,
"voice_ids": null,
"middle_image_urls": null,
"duration": null,
"resolution": "1080p",
"aspect_ratio": null
}The generated video.
{
"video": {
"content_type": "video/mp4",
"url": "https://v3b.fal.media/files/b/0aac4496/QzdMSy4uSKyFfMjtU65MA_clip_text.mp4",
"file_name": "output.mp4",
"file_size": 3478246
}
}url string* requiredThe URL where the file can be downloaded from.
content_type stringThe mime type of the file.
file_name stringThe name of the file. It will be auto-generated if not provided.
file_size integerThe size of the file in bytes.
frontal_image_url stringThe frontal image of the element (main view).
Additional views of the element from different angles (1-3).
video_url stringA video of the element, used instead of images (3-8s).
voice_id stringVoice bound to this element. Create one with https://fal.ai/models/fal-ai/kling-video/create-voice