Kling 3.0 Omni

Kuaishou · ~5 min

from $0.088per second

All-in-one Kling 3.0: from a description, frames, up to 7 reference photos or your video — edit it or use it as a reference. Up to 15 s, up to 4K.

Kling 3.0 Omni is Kuaishou's all-in-one model. 3 to 15 second clips from a description, the first and last frame, references (up to 7 photos — refer to them as «photo 1», «photo 2» in the description) or your video.

With a video (3–10 seconds, longer is trimmed) there are two modes: «Edit this video» — the result is as long as the clip; «Use as a reference» — a new clip of the chosen length in the spirit of yours (one photo allowed, as the first frame). With a video 720p and 1080p are available, no sound is generated, but the clip's own sound can be kept.

Quality: Standard (720p), Pro (1080p) or 4K. Sound without a video is optional and costs more. You pay per second of the clip.

One model, kling-3.0-omni · ~5 min. The result follows the input fields (prompt, frames, references, video_mode, duration) — there are no separate «animate / edit» endpoints.

Features

generate_audio — audio in the clip

Price

Resolution	No sound, per second	With sound, per second	With your video, per second
720p	$0.088	$0.117	$0.132
1080p	$0.117	$0.146	$0.175
4k	$0.558	$0.558	—

Price = per-second price × clip length, rounded up to $0.001. Charged when the task is created and fully refunded if it fails.
With your video (video_urls, one clip 3–10 s): video_mode: "edit" is billed by the clip seconds, the result has the same length; video_mode: "reference" by the new clip seconds (duration). The «With your video» rate applies; 4K is not available with a video, no sound is generated.
Reference photos in the prompt: <<<image_1>>>, <<<image_2>>>… You can write «photo 1» — we convert it; with no references at all, every photo is named at the start of the prompt.
generate_audio defaults to false. In 4K the price is the same with or without sound.

Media limits

Type	Limits
Images	up to 7; JPG / PNG / WebP; upload via files/upload — up to 30 MB per file
Video	one; 3…10 s (longer is always trimmed to 10); the service needs ≥ 720 px on the short side — smaller clips are upscaled for you; MP4 / MOV → MP4; upload ≤ 200 MB

Photos — public https or upload; video and audio — files/upload only.

Parameters (field `input`)

Parameter	Description	Values (default in bold)
`prompt`	What happens in the clip: scene, motion, camera, light, style	text, up to 2500 chars
`first_frame_url`	First frame: a photo link (https); the video starts from it	`"https://…"`
`last_frame_url`	Last frame (optional, only together with the first one)	`"https://…"`
`image_urls`	Reference photos (https)	`["https://…"]`, up to 7
`video_urls`	One video of yours (MP4, 3–10 s; longer is trimmed): upload via files/upload first. 720p / 1080p only	`["https://…"]`, up to 1
`video_mode`	What to do with your video: `edit` (default) — change it, the result is as long as the clip (3–10 s), up to 4 photos; `reference` — a new clip of `duration` based on it, one photo allowed (the first frame)	`edit` · `reference`
`resolution`	Quality = the Kling mode: `720p` — Standard (std), `1080p` — Pro (pro), `4k` — 4K. You can also send `mode`: `std` / `pro` / `4k`	`720p` · `1080p` · `4k`
`aspect_ratio`	Aspect ratio	`16:9` · `9:16` · `1:1`
`duration`	Clip length in seconds (not needed with `video_mode: "edit"` — the clip sets the length)	3 to 15 (default `5`)
`generate_audio`	Sound in the clip (effects, music, voices). Default `false`; with sound costs more — see the price. Not generated with `video_urls`	`true` `false` (default `false`)
`keep_original_sound`	Keep the sound of your video in the result	`true` `false` (default `true`)

Examples

Prompt only

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kling-3.0-omni","input":{"prompt":"A drone flies over an autumn forest at sunrise, fog, cinematic","resolution":"720p","aspect_ratio":"16:9","duration":"5"}}'

import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "kling-3.0-omni",
      "input": {
        "prompt": "A drone flies over an autumn forest at sunrise, fog, cinematic",
        "resolution": "720p",
        "aspect_ratio": "16:9",
        "duration": "5"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}

const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "kling-3.0-omni",
    "input": {
      "prompt": "A drone flies over an autumn forest at sunrise, fog, cinematic",
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "duration": "5"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

With a first frame

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kling-3.0-omni","input":{"prompt":"The character slowly turns to the camera, the wind moves the hair","first_frame_url":"https://mixmedia.tech/static/img/previews/gpt-t2i.jpg","resolution":"720p","duration":"5"}}'

import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "kling-3.0-omni",
      "input": {
        "prompt": "The character slowly turns to the camera, the wind moves the hair",
        "first_frame_url": "https://mixmedia.tech/static/img/previews/gpt-t2i.jpg",
        "resolution": "720p",
        "duration": "5"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}

const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "kling-3.0-omni",
    "input": {
      "prompt": "The character slowly turns to the camera, the wind moves the hair",
      "first_frame_url": "https://mixmedia.tech/static/img/previews/gpt-t2i.jpg",
      "resolution": "720p",
      "duration": "5"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

With references

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kling-3.0-omni","input":{"prompt":"A drone flies over an autumn forest at sunrise, fog, cinematic","image_urls":["https://mixmedia.tech/static/img/previews/gpt-t2i.jpg"],"resolution":"720p","aspect_ratio":"16:9","duration":"5"}}'

import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "kling-3.0-omni",
      "input": {
        "prompt": "A drone flies over an autumn forest at sunrise, fog, cinematic",
        "image_urls": [
          "https://mixmedia.tech/static/img/previews/gpt-t2i.jpg"
        ],
        "resolution": "720p",
        "aspect_ratio": "16:9",
        "duration": "5"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}

const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "kling-3.0-omni",
    "input": {
      "prompt": "A drone flies over an autumn forest at sunrise, fog, cinematic",
      "image_urls": [
        "https://mixmedia.tech/static/img/previews/gpt-t2i.jpg"
      ],
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "duration": "5"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

With your video

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kling-3.0-omni","input":{"prompt":"Make the clip anime style, keep everything else","video_urls":["https://mixmedia.tech/files/<id>.mp4"],"video_mode":"edit","resolution":"720p","duration":"5"}}'

import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "kling-3.0-omni",
      "input": {
        "prompt": "Make the clip anime style, keep everything else",
        "video_urls": [
          "https://mixmedia.tech/files/<id>.mp4"
        ],
        "video_mode": "edit",
        "resolution": "720p",
        "duration": "5"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}

const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "kling-3.0-omni",
    "input": {
      "prompt": "Make the clip anime style, keep everything else",
      "video_urls": [
        "https://mixmedia.tech/files/<id>.mp4"
      ],
      "video_mode": "edit",
      "resolution": "720p",
      "duration": "5"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

Create and result

POST /api/v1/jobs/createTask with model and input.
Poll GET /api/v1/jobs/recordInfo?taskId=… every 3–5 s (or a callback).

Successful createTask (HTTP 200)

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_...",
    "task_id": "task_...",
    "status": "submitted"
  }
}

Completed task (recordInfo)

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_...",
    "task_id": "task_...",
    "state": "success",
    "status": "completed",
    "costUsd": "0.384",
    "refunded": false,
    "resultJson": {
      "videos": [
        {
          "url": "https://…/out.mp4"
        }
      ],
      "duration": 8
    }
  }
}

Aliases: task_id = taskId; status: pending / processing / completed / failed alongside state. Clip URL is in resultJson. size is an alias of aspect_ratio in input.

Photos can be any public https links or uploads via files/upload. Videos and audio — via files/upload only.

Error handling

API responses are JSON {"code", "msg", "data"}; errors also have a string error field (type). On /api/v1/* the HTTP status matches body code.

Example response bodies

400

{
  "code": 400,
  "msg": "input.duration: must be between 4 and 30, or \"auto\" / -1",
  "data": null,
  "error": "invalid_request_error"
}

401

{
  "code": 401,
  "msg": "Authentication failed. Please check your API key",
  "data": null,
  "error": "authentication_error"
}

402

{
  "code": 402,
  "msg": "Insufficient balance. Please top up and try again. Available: $0.01, required: $0.015. Top up at https://mixmedia.tech/cabinet/billing",
  "data": {
    "balance": "0.0100",
    "required": "0.0150",
    "currency": "USD",
    "topUpUrl": "https://mixmedia.tech/cabinet/billing"
  },
  "error": "payment_required"
}

429

{
  "code": 429,
  "msg": "Rate limit exceeded: 10 createTask/upload requests per 10 s per key. Retry after 8s",
  "data": null,
  "error": "rate_limit_error"
}

500

{
  "code": 500,
  "msg": "Internal server error",
  "data": null,
  "error": "server_error"
}

Codes on createTask / upload

code	error	Meaning	What to do
400	`invalid_request_error`	Invalid parameter or body	See `msg`
400	`unsupported_model`	Unknown model	Model list
400	`nsfw_content_detected`	Moderation / content policy — `msg` / `failMsg` is the upstream text verbatim	Read the refusal text, change the prompt or files
401	`authentication_error`	Missing or invalid key	Check the key
402	`payment_required`	Not enough balance	Top up
403	`permission_error`	No access	Contact support
429	`rate_limit_error`	Too many requests	Wait for `Retry-After`
505	`model_disabled`	Model temporarily disabled	Pick another
500	`server_error`	Our failure	Retry later

Example msg values: Authentication failed. Please check your API key (401); Insufficient balance. Please top up and try again… (402).

Task errors (recordInfo)

If the task was created and then failed: state: "fail" (alias status: "failed"), failCode / failMsg, and error: { code, message, type }. Money is refunded (refunded: true).

failCode	error.type	Meaning
400	`nsfw_content_detected` / `invalid_request_error`	Moderation — `failMsg` is upstream text verbatim
422	`invalid_request_error`	The model rejected the parameters (length, mode, resolution, file)
501	`server_error`	The model could not generate (`failMsg`)
504	`timeout_error`	Timed out — retry
500 / 503	`server_error`	Service temporarily unavailable

Rate limits

What	Limit
createTask and upload	20 per 10 s per key
recordInfo / list / balance	100 per 10 s per key

Over the limit — HTTP 429 and Retry-After.

#Features

#Price

#Media limits

#Parameters (field input)

#Examples

#Prompt only

#With a first frame

#With references

#With your video

#Create and result

#Successful createTask (HTTP 200)

#Completed task (recordInfo)

#Error handling

#Example response bodies

#Codes on createTask / upload

#Task errors (recordInfo)

#Rate limits