Platform
Checking your session…
← All models

Input types: Text, Image, VideoOutput: Video

KlingKling 4.0 Flash

Kling 4.0 Omni — up to 30s at 720p or 1080p from text, frames, reference images, a reference or base video, and elements.

Image + Video Input1080p30 sec

Use it in code

Use it with AI

Overview

Alongside the unified model APIs, we expose compatibility APIs that take each vendor's original parameters exactly as the vendor defines them — nothing renamed, nothing reshaped on the way through.

That makes them the shortest path onto Picsart if you already work with the vendor directly: the request bodies you've already written keep working as they are. You keep their parameter names and defaults, and you get the vendor's full parameter set rather than the subset that is shared across every model.

The cost is that a request is written for one vendor — switching models later means rewriting it, and results come back in the vendor's own shape. When you'd rather write once and change models freely, use the unified API.

Make a request

Call the workflow with ai.apis.run() in TypeScript, or hit /workflows/{workflow}/execute directly — params is passed through untouched either way.

These endpoints are addressed by workflow name rather than model id: the one in this model's header, since one model runs as one workflow. Authentication is unchanged — your Picsart API key as a bearer token (see Authentication).

ts
import { createClient, ApiRunMode } from '@picsart/ai-sdk';

const ai = createClient({
  apiKey: process.env.PICSART_API_KEY,
  apiUrl: 'https://api.picsart.com',
});

// Calls the 'kling-omni-video' workflow directly — params are sent as-is.
const { result, usage } = await ai.apis.run('kling-omni-video', {
  prompt: "A serene mountain lake at golden hour, ultra detailed"
}, {
  mode: ApiRunMode.SYNC,
});

console.log(result); // workflow-specific output
console.log(usage?.credits); // amount charged, in $

Async (submit & poll)

This model can run longer than the sync limit (~20s). In TypeScript, ai.apis.run(…, { mode: ApiRunMode.ASYNC }) polls for you; over HTTP, submit and poll yourself.

ts
import { createClient, ApiRunMode } from '@picsart/ai-sdk';

const ai = createClient({
  apiKey: process.env.PICSART_API_KEY,
  apiUrl: 'https://api.picsart.com',
});

// mode: ASYNC submits the job and polls under the hood — you just await.
const { result } = await ai.apis.run('kling-omni-video', {
  prompt: "A serene mountain lake at golden hour, ultra detailed"
}, {
  mode: ApiRunMode.ASYNC,
});

console.log(result);

Parameters

14 parameters, sent inside params. These are the vendor's own names, so they line up one-for-one with the vendor's documentation. Required ones must be supplied; the rest fall back to their defaults.

ParameterTypeRequiredDefaultDetails
model_name
Model name for Kling Omni video generation
stringnokling-video-o1
kling-video-o1kling-v3-omnikling-v4-omni
prompt
Prompt text for video generation (max 2500 characters; `kling-v4-flash-omni` / `kling-v4-omni`: English-only up to 26000, non-English-only up to 11000). Optional when multi_shot is enabled.
stringno——
image_list
List of reference images
ReferenceImage[]no——
└image_url
URI of the reference image
stringyes——
└type
Type of the reference image (omitted = reference image). `middle_frame` is only supported by `kling-v4-omni`; `end_frame` is not supported by `kling-v4-flash-omni`.
stringno—
first_frameend_framemiddle_frame
element_list
List of element IDs
Element[]no——
└element_id
Id of the created element
stringyes——
video_list
Reference video configuration
ReferenceVideo[]no——
└video_url
URI of the reference image
stringyes——
└refer_type
Type of the refer (vendor default: base)
stringno—
featurebase
└keep_original_sound
Either keep the original sound or no. Not supported by `kling-v4-flash-omni` / `kling-v4-omni`.
stringno—
yesno
sound
Generate sound simultaneously when generating videos. Not supported by `kling-v4-flash-omni` / `kling-v4-omni`.
stringno—
onoff
mode
Mode for video generation (std, pro, or 4k). Both omni models support std/pro. mode=4k is only supported by kling-v3-omni and is incompatible with reference video (video_list). Not supported by kling-v4-flash-omni / kling-v4-omni (use resolution instead).
stringno—
stdpro4k
aspect_ratio
Aspect ratio for the video. `21:9` and `adaptive` are only supported by `kling-v4-flash-omni` / `kling-v4-omni`.
stringno16:9
16:99:161:121:9adaptive
resolution
Output resolution of the generated video. Only supported by `kling-v4-omni` (720p or 1080p) and `kling-v4-flash-omni` (720p only); defaults to 720p when omitted.
stringno—
720p1080p
duration
Duration of the video in seconds. o1 models: 5 or 10. v3-omni models: 3-15. v4-flash-omni: 3-20. v4-omni: 3-30.
stringno5
5103467891112131415161718192021222324252627282930
multi_shot
Enable multi-shot video generation (v3-omni)
booleanno——
shot_type
Shot segmentation type for multi-shot generation. Omni only supports customize.
stringno—
customize
multi_prompt
List of prompts for each shot in multi-shot mode (max 6 items)
MultiPromptItem[]no——
└index
Index of the shot (starting from 0)
numberyes——
└prompt
Prompt text for this shot (max 512 characters)
stringyes——
└duration
Duration of this shot in seconds
stringyes——
options
Options controlling safety checks and drive integration
objectno——
└safety_checks
Safety check settings
objectno——
└enabled
Whether to run content moderation. Defaults to true.
booleanno——
└drive
Save result to Picsart Drive
objectno——
└name
File name in Picsart Drive
stringyes——
└attributes
Custom attributes to attach to the file
objectno——
└folder
Target folder in Picsart Drive
objectno——
└inputs_transformation
Input transformation settings
objectno——
└downscale_oversized_images
Whether to downscale oversized input images. Defaults to false.
booleanno——

Response

Over HTTP the output arrives inside a status envelope, at response.result. ai.apis.run() unwraps that envelope for you and resolves to { result, usage } instead. Either way the result itself is the vendor's own shape.

json
{
  "result": {
    "url": "https://cdn.picsart.com/…/result.mp4",
    "duration": "…",
    "mimeType": "video/mp4",
    "driveFile": {
      "id": "wf_abc123"
    }
  }
}