Kling V3 Omni API

Create videos with Kling V3 Omni using text, images, video. Available resolutions: 720p / 1080p. Try the current API settings, preview results and reuse your inputs.

Modalities

TextImageVideoVideo

Published

Standard

$0/ request

Platform price · USD

Input

Generation mode720p · $0 / secondPrompt 223 / 100,000

resolutionaspect ratiogenerate audio

Duration3–15 seconds

Request preview

{
  "model": "kling-v3-omni",
  "input": {
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "prompt": "Macro commercial film of an imaginary translucent cobalt perfume bottle on wet black stone. A soft light travels across the glass, condensation slowly forms, and the camera makes one controlled half-orbit. No logos or text."
  }
}

API keySign in to generate

API key for this model

Output

Example output

Open original ↗

Build with this model

The example follows your Playground parameters.

curl --request POST 'https://vip.astralgames.ai/v1/tasks' \
  --header 'Content-Type: application/json' \
  --header "Authorization: Bearer $MODEL_API_KEY" \
  --data '{
  "model": "kling-v3-omni",
  "input": {
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "prompt": "Macro commercial film of an imaginary translucent cobalt perfume bottle on wet black stone. A soft light travels across the glass, condensation slowly forms, and the camera makes one controlled half-orbit. No logos or text."
  }
}'

Set MODEL_API_KEY in your environment. Keep your secret key on the server. Full documentation ↗

Kling V3 Omni pricing

Estimate one request, then choose a budget for your workflow.

Specification

Usage	Quantity	Rate	Cost
Standard	1 request	$0/ request	$0

Cost per request$0

Public USD estimate. Your account rate and final recorded usage determine the actual charge.

View all specifications and prices

Specification	Our price	Official reference
Standard	$0 / request	—

Related models

Video models ↗

Model	Price	Resolution	Input → output
KuaishouKling V3 OmniCurrent	$0 / request	720p / 1080p	TextImageVideoVideo
GoogleGemini Omni FlashBoth declare text, image, video inputSame billing units	$0 / request	720p	TextImageVideoVideo
ByteDanceSeedance 2.0Both declare text, image, video input	$0.05 / second	480p / 720p / 1080p	TextImageVideoAudioVideo
ByteDanceSeedance 2.0 FastBoth declare text, image, video input	$0.03 / second	480p / 720p	TextImageVideoAudioVideo
KuaishouKling V3Both declare text, image inputSame billing units	$0 / request	720p / 1080p	TextImageVideo

See what it can create.

Capability-based prompts and platform-generated examples are labeled separately, with their sources.

Official capability source ↗ · 2026-10-14

Reference-guided video

Use the supplied scene and character references for a clip of the character entering a courtyard and turning toward the camera. Preserve design consistency with a slow pullback.

Use the model’s supported reference mode and specify the traits that should remain consistent.

Multi-shot storytelling

Shot 1: a wide street after rain. Shot 2: an original robot picks up a paper lantern. Shot 3: a close-up as it lights up. Preserve character, lighting and action continuity.

Describe narrative beats shot by shot; choose durations and shot options from the actual API.

Platform-generated examples

Macro product film

View prompt

Macro commercial film of an imaginary translucent cobalt perfume bottle on wet black stone. A soft light travels across the glass, condensation slowly forms, and the camera makes one controlled half-orbit. No logos or text.

Original media ↗Try this prompt ↗

Coastal architecture tracking shot

View prompt

One continuous cinematic tracking shot through a quiet coastal library at sunrise. Linen curtains move in a light breeze, reflected water ripples naturally, and the camera glides forward at walking speed.

Original media ↗Try this prompt ↗

Vertical fashion motion study

View prompt

Vertical editorial fashion motion study in a minimal cobalt studio. A model in an original sculptural ivory outfit turns once while fabric moves naturally and the camera performs a gentle handheld push.

Original media ↗Try this prompt ↗

Miniature workshop story

View prompt

A whimsical miniature workshop where tiny original robot craftspeople assemble a paper lantern. Warm practical lights flicker, small tools move with believable weight, and the camera slowly cranes down.

Original media ↗Try this prompt ↗

What is Kling V3 Omni?

Create videos with Kling V3 Omni using text, images, video. Available resolutions: 720p / 1080p. Try the current API settings, preview results and reuse your inputs.

Kling VIDEO 3.0 Omni combines multimodal references, voiced characters and storyboard narration with shot-level direction.

Official model information ↗ · 2026-10-14

Kling V3 Omni specifications

Model ID	kling-v3-omni
Provider	Kuaishou
API	/v1/tasks
Resolution	720p / 1080p
Aspect ratio	16:9 / 9:16 / 1:1
Duration	3–15 seconds
Reference images	Up to 3
Frame images	Up to 2
Reference videos	Up to 1
Generated audio	Configurable; reference-video restrictions may apply

Before you generate

Use the current model ID and the API request shape shown on this page.
Generation is asynchronous. Keep the returned task ID to retrieve the result and billing status.
Frame and reference modes may be mutually exclusive. Check the combination constraints before submitting.
Only options supported by the current platform contract are exposed in Playground.

Compare Kling V3 Omni with related models

Specification	Kling V3 Omni	Gemini Omni Flash	Seedance 2.0
Provider	Kuaishou	Google	ByteDance
Input → output	TextImageVideoVideo	TextImageVideoVideo	TextImageVideoAudioVideo
Start / end frames	Supported · 1 or 2 images	—	Supported · 1 or 2 images
Reference videos	1	1	3
Reference audio	—	—	3
Selection basis	Current model	Both declare text, image, video input · Same billing units	Both declare text, image, video input
Resolution	720p / 1080p	720p	480p / 720p / 1080p
Reference images	3	20	9
Starting price	$0 / request	$0 / request	$0.05 / second

Choose by the input types, output settings and billing unit your workflow needs. Try the same prompt across models to compare results for your own use case.

BUILD WITH ASTRAL NEXUS

Build with Kling V3 Omni in your app

Submit parameters through the Media Tasks API, then retrieve the result with the task ID. Image and video models keep their own input requirements.

01
Get your API key
Sign in and prepare a key with access to this model.
02
Configure your request
Choose parameters in Playground and copy the API example.
03
Run and inspect the result
Review status, outputs and charges in History.

Read the model API guide ↗

API integration

POST /v1/tasks · Authorization: Bearer

cURL

curl 'https://vip.astralgames.ai/v1/tasks' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MODEL_API_KEY" \
  --data '{
  "model": "kling-v3-omni",
  "input": {
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "prompt": "A quiet mountain lake at sunrise, soft morning light."
  }
}'

JavaScript

const response = await fetch("https://vip.astralgames.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer $MODEL_API_KEY"
  },
  body: JSON.stringify({
    "model": "kling-v3-omni",
    "input": {
      "seconds": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true,
      "prompt": "A quiet mountain lake at sunrise, soft morning light."
    }
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.text());

Python

import json
import requests

response = requests.post(
    "https://vip.astralgames.ai/v1/tasks",
    headers=json.loads("{\"Content-Type\":\"application/json\",\"Authorization\":\"Bearer $MODEL_API_KEY\"}"),
    json=json.loads("{\"model\":\"kling-v3-omni\",\"input\":{\"seconds\":5,\"resolution\":\"720p\",\"aspect_ratio\":\"16:9\",\"generate_audio\":true,\"prompt\":\"A quiet mountain lake at sunrise, soft morning light.\"}}"),
    timeout=300,
)
response.raise_for_status()
print(response.text)

Poll the returned task ID for processing status and output assets.

curl -H "Authorization: Bearer $MODEL_API_KEY" "https://vip.astralgames.ai/v1/tasks/$TASK_ID"

Documentation: Authentication · Task status and results · Error handling

Full API parameters and combination constraints

Request parameters

Parameter	Type	Values & constraints
`images`	array
`prompt` *	string
`videos`	array
`seconds`	integer	Default: 5
`resolution`	JSON	"720p" · "1080p"Default: "720p"
`aspect_ratio`	JSON	"16:9" · "9:16" · "1:1"Default: "16:9"
`frames_images`	array
`generate_audio`	boolean	Default: true

Full JSON Schema and combination constraints

{
  "type": "object",
  "allOf": [
    {
      "not": {
        "required": [
          "videos",
          "frames_images"
        ]
      }
    },
    {
      "if": {
        "required": [
          "videos"
        ]
      },
      "then": {
        "required": [
          "generate_audio"
        ],
        "properties": {
          "generate_audio": {
            "const": false
          }
        }
      }
    }
  ],
  "required": [
    "prompt"
  ],
  "properties": {
    "images": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "pattern": "^https?://"
      },
      "maxItems": 3,
      "minItems": 1
    },
    "prompt": {
      "type": "string",
      "maxLength": 100000,
      "minLength": 1
    },
    "videos": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "pattern": "^https?://"
      },
      "maxItems": 1,
      "minItems": 1
    },
    "seconds": {
      "type": "integer",
      "default": 5,
      "maximum": 15,
      "minimum": 3
    },
    "resolution": {
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "720p"
    },
    "aspect_ratio": {
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "frames_images": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "pattern": "^https?://"
      },
      "maxItems": 2,
      "minItems": 1
    },
    "generate_audio": {
      "type": "boolean",
      "default": true
    }
  },
  "additionalProperties": false
}

Kling V3 Omni API · Common questions

Answers about pricing, inputs, integration and results.

How much does Kling V3 Omni cost?

The current public price starts at $0 / request. The pricing section lists each specification. Playground checks your account price before submitting; the completed request records the final charge.

How do I get a Astral Nexus API key?

Sign in and open Quick Start above the workspace. Select or create a key with access to this model, then copy the request example.

Which inputs and output settings are supported?

Supported input fields: images, prompt, videos, seconds, resolution, aspect_ratio, frames_images, generate_audio. The parameter table includes allowed values and defaults.

Can I use reference images?

Yes. Use the reference mode to upload images or supply their URLs. The current limit is 3 images. Reference images guide a new generation; they do not imply mask editing support.

How do I retrieve results and past requests?

Save the returned task ID and query the task until it succeeds or fails. The History tab lets you reopen your tasks and reuse their parameters.

What happens if the model is closed?

The model keeps its page and identity, but new generation requests are blocked. Existing task records remain accessible. An upstream outage is reported separately from an administrator closing the model.

Read the API documentation ↗