KuaishouvideoNewOperational

Kling 3.0 Omni Reference to Video API

Name: Kling 3.0 Omni API
Brand: Kuaishou
Availability: InStock

Reference to Video with Kling 3.0 Omni by Kuaishou. Kling 3.0 with multi-image references for consistent characters.

kuaishou/kling-3.0-omni/reference-to-video

FromUp to −12%

$0.074/s$0.084

per second of video · 720p

Open in Studio API

Try Kling 3.0 Omni Reference to Video

Prompt*

Type @ to point at a reference image0/5000

Reference images*

Up to 7 images for characters, products, style or scene. Refer to them in the prompt as @Image1, @Image2…

Aspect ratio

Output frame shape.

Resolution

Output resolution. Higher resolutions cost more per second.

Duration

Length of the generated clip in seconds (3–15s). You pay per second.

Generate audio

Generate synchronized sound, ambience and dialogue. Clips with audio are billed at a higher per-second rate.

Estimated cost…

Create a free account with Google or email — pay only for what you generate.

Your video will appear here

Write a prompt, pick your settings and hit Run. You only pay for successful generations.

Also available: Kling 3.0 Omni Text to Video · Kling 3.0 Omni Image to Video

Kling 3.0 Omni Reference to Video API

POST/api/v1/run/kuaishou/kling-3.0-omni/reference-to-video

Submits an asynchronous job and returns 202 with a generation id. Poll GET /api/v1/generations/{id} or pass webhook_url. See job lifecycle.

Input parameters

Name	Type	Description	Affects price
`prompt`required	string	Describe the shot: subject, action, camera movement, lighting and style.	No
`reference_image_urls`required	string[] (URLs)	Up to 7 images for characters, products, style or scene. Refer to them in the prompt as @Image1, @Image2… Max items: 7	No
`aspect_ratio`	string (enum)	Output frame shape. Values: 16:9 · 9:16 · 1:1 Default: 16:9	Yes
`resolution`	string (enum)	Output resolution. Higher resolutions cost more per second. Values: 720p · 1080p Default: 720p	Yes
`duration`	integer	Length of the generated clip in seconds (3–15s). You pay per second. Range: 3–15s Default: 5	Yes
`generate_audio`	boolean	Generate synchronized sound, ambience and dialogue. Clips with audio are billed at a higher per-second rate. Default: false	Yes
`negative_prompt`	string	Things to avoid in the output.	No
`webhook_url`	string (URL)	Optional. We POST the finished generation here, signed with your webhook secret. Webhooks	No

Request

curl -X POST https://cheapergen.com/api/v1/run/kuaishou/kling-3.0-omni/reference-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "@Image1 walks into the café from @Image2 and sits by the window, handheld camera",
  "reference_image_urls": [
    "https://cdn.cheapergen.ai/samples/reference-1.jpg",
    "https://cdn.cheapergen.ai/samples/reference-2.jpg"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/kuaishou/kling-3.0-omni/reference-to-video", headers=headers, json={
    "prompt": "@Image1 walks into the café from @Image2 and sits by the window, handheld camera",
    "reference_image_urls": [
        "https://cdn.cheapergen.ai/samples/reference-1.jpg",
        "https://cdn.cheapergen.ai/samples/reference-2.jpg"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/kuaishou/kling-3.0-omni/reference-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "@Image1 walks into the café from @Image2 and sits by the window, handheld camera",
    "reference_image_urls": [
      "https://cdn.cheapergen.ai/samples/reference-1.jpg",
      "https://cdn.cheapergen.ai/samples/reference-2.jpg"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

Response

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "kuaishou/kling-3.0-omni",
  "endpoint": "kuaishou/kling-3.0-omni/reference-to-video",
  "mode": "reference-to-video",
  "status": "queued",
  "input": {
    "prompt": "@Image1 walks into the café from @Image2 and sits by the window, handheld camera",
    "reference_image_urls": [
      "https://cdn.cheapergen.ai/samples/reference-1.jpg",
      "https://cdn.cheapergen.ai/samples/reference-2.jpg"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "kuaishou/kling-3.0-omni",
  "endpoint": "kuaishou/kling-3.0-omni/reference-to-video",
  "mode": "reference-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "@Image1 walks into the café from @Image2 and sits by the window, handheld camera",
    "reference_image_urls": [
      "https://cdn.cheapergen.ai/samples/reference-1.jpg",
      "https://cdn.cheapergen.ai/samples/reference-2.jpg"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.ai/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

Kling 3.0 Omni pricing

Pay per second of video. No subscription. Failed generations are refunded automatically.

Tier	Official price	Cheaper Gen.	You save
720p silent	~~$0.084~~/s	$0.074/s	−12%
720p + audio with native audio	~~$0.112~~/s	$0.099/s	−12%
1080p silent	~~$0.112~~/s	$0.099/s	−12%
1080p + audio with native audio	~~$0.14~~/s	$0.123/s	−12%

Official price: Kling developer API list price for Kling 3.0 Omni without video input ($0.084 / s at 720p, $0.112 / s at 1080p; with native audio $0.112 / $0.14). Prices verified 2026-10-16.
Reference images are included in the price.
Native audio is billed at a higher per-second rate.

About Kling 3.0 Omni All Kling 3.0 Omni endpoints