# Kling 3.0 Omni

> Kling 3.0 Omni unified video model: text, first/last-frame and reference generation with up to 7 images or subjects, up to 4K, 3–15 seconds

- Model page: https://yir.ai/models/kling-3-omni
- Model ID: `klingai/kling-3.0-omni`
- Billing: by the channel that ran the job; attempts the upstream did not bill are free.

## Pricing

Current public prices by channel for the same output specification; official prices are a reference. You are billed by the channel that actually runs the job, which may change on failover.

| Output specification | Channel | Public price |
|---|---|---|
| 720p · no audio | Kling AI (official) | $0.084 / second |
| 720p · no audio | APIMart | $0.0672 / second |
| 720p · no audio | KIE | $0.0755 / second |
| 720p · no audio | FAL | $0.084 / second |
| 720p · audio | Kling AI (official) | $0.112 / second |
| 720p · audio | APIMart | $0.0896 / second |
| 720p · audio | KIE | $0.101 / second |
| 720p · audio | FAL | $0.112 / second |
| 1080p · no audio | Kling AI (official) | $0.112 / second |
| 1080p · no audio | APIMart | $0.0896 / second |
| 1080p · no audio | KIE | $0.101 / second |
| 1080p · no audio | FAL · pro | $0.112 / second |
| 1080p · audio | Kling AI (official) | $0.14 / second |
| 1080p · audio | APIMart | $0.112 / second |
| 1080p · audio | KIE | $0.126 / second |
| 1080p · audio | FAL · pro | $0.14 / second |
| 4K | Kling AI (official) | $0.42 / second |
| 4K | KIE | $0.3775 / second |
| 4K | FAL · native4k | $0.42 / second |
| 4K | APIMart | $0.4286 / second |

## Parameters

- Operation: `generate_video`

| Parameter | Values | Default |
|---|---|---|
| `input` | text / reference / image | text |
| `resolution` | 720p / 1080p / 4K | 720p |
| `aspect_ratio` | 16:9 / 9:16 / 1:1 | 16:9 |
| `duration` | 3 / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 | 5 |
| `generate_audio` | true / false | false |

## Integration

Pick either: the official SDK for new code, or swap the Base URL in projects already using the OpenAI protocol.

### Official SDK (TypeScript)

The SDK calls the Standard API (https://gateway.yir.ai) to submit, wait for and collect jobs; a Go SDK is also available. https://yir.ai/docs/integrations/sdk

```bash
pnpm add @yir-ai/sdk
```

```ts
import { createNodeYirClient } from "@yir-ai/sdk/server";

// Reads YIR_API_KEY from the environment by default: process.env.YIR_API_KEY
const client = createNodeYirClient();

// 1. Submit a video generation job
const job = await client.submitVideo({
  model: "klingai/kling-3.0-omni",
  input: {
    type: "text",
    prompt: "A sea turtle swims slowly over a coral reef. The camera tracks smoothly from the side as sunlight filters through clear water, casting moving patterns across its shell",
  },
  parameters: {
    duration: 5,
    resolution: "720p",
    aspect_ratio: "16:9",
    generate_audio: false,
    n: 1,
  },
});

// 2. Wait for the job to finish and deliver its result
const result = await client.waitForJob(job.id);
console.log("Delivered files:", result.result);
if (result.result && "files" in result.result) {
  for (const file of result.result.files) {
    console.log("->", file.url);
  }
}
```

### OpenAI-compatible API

OpenAI Images and Sora Videos protocols for OpenAI SDKs and gateways such as new-api; no chat. https://yir.ai/docs/integrations/openai-compatibility

- OpenAI SDK base_url: `https://gateway.yir.ai/openai/v1`
- new-api channel Base URL (channel type OpenAI): `https://gateway.yir.ai/openai`
- Model ID: `klingai/kling-3.0-omni`

```bash
curl https://gateway.yir.ai/openai/v1/videos \
  -H "Authorization: Bearer $YIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "klingai/kling-3.0-omni",
    "prompt": "A sea turtle swims slowly over a coral reef. The camera tracks smoothly from the side as sunlight filters through clear water, casting moving patterns across its shell",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "seconds": "5"
  }'
```

## FAQ

### Does Kling 3.0 Omni have an official API?

Yes. Kling AI sells Kling 3.0 Omni through its own official API. At the same specification, third-party providers on Yir list it for up to 20% less (see the table above), and you call them all with one Yir API key.

## Rules

- Authenticate with Authorization: Bearer $YIR_API_KEY; keep the key in a server environment variable, never in browser code, source control, prompts or logs.
- Jobs are asynchronous: keep the Job ID, wait for a terminal state, then read the result; handle failure and cancellation.
- For safe retries, reuse the same idempotency key and request; do not blindly resubmit when the result is unknown.
- Result URLs are temporary; copy files elsewhere if you need to keep them.

## Links

- [Quickstart](https://yir.ai/docs/getting-started/quickstart)
- [API reference](https://yir.ai/docs/reference)
- [llms.txt](https://yir.ai/llms.txt)
