# Kling 3.0 Omni

> Kling 3.0 Omni 統合マルチモーダル動画モデル。テキスト、開始・終了フレーム、最大7枚の参照画像または被写体から、最大4K・3～15秒の動画を生成

- モデルページ: https://yir.ai/ja/models/kling-3-omni
- モデル ID: `klingai/kling-3.0-omni`
- 課金：ジョブを実行したチャネルの価格で請求。上流が課金しなかった試行は無料です。

## 価格

同じ出力仕様での現在のチャネル別公開価格です。公式価格は参考値です。請求は実際にジョブを実行したチャネルに基づき、フェイルオーバー時には変わる場合があります。

| 出力仕様 | チャネル | 公開価格 |
|---|---|---|
| 720p · 音声なし | Kling AI (公式) | $0.084 / 秒 |
| 720p · 音声なし | APIMart | $0.0672 / 秒 |
| 720p · 音声なし | KIE | $0.0755 / 秒 |
| 720p · 音声なし | FAL | $0.084 / 秒 |
| 720p · 音声あり | Kling AI (公式) | $0.112 / 秒 |
| 720p · 音声あり | APIMart | $0.0896 / 秒 |
| 720p · 音声あり | KIE | $0.101 / 秒 |
| 720p · 音声あり | FAL | $0.112 / 秒 |
| 1080p · 音声なし | Kling AI (公式) | $0.112 / 秒 |
| 1080p · 音声なし | APIMart | $0.0896 / 秒 |
| 1080p · 音声なし | KIE | $0.101 / 秒 |
| 1080p · 音声なし | FAL · pro | $0.112 / 秒 |
| 1080p · 音声あり | Kling AI (公式) | $0.14 / 秒 |
| 1080p · 音声あり | APIMart | $0.112 / 秒 |
| 1080p · 音声あり | KIE | $0.126 / 秒 |
| 1080p · 音声あり | FAL · pro | $0.14 / 秒 |
| 4K | Kling AI (公式) | $0.42 / 秒 |
| 4K | KIE | $0.3775 / 秒 |
| 4K | FAL · native4k | $0.42 / 秒 |
| 4K | APIMart | $0.4286 / 秒 |

## パラメータ

- 操作: `generate_video`

| パラメータ | 値 | デフォルト |
|---|---|---|
| `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 |

## 組み込み

どちらかを選んでください。新しいコードには公式 SDK、OpenAI プロトコルを使っている既存プロジェクトには Base URL の差し替えがおすすめです。

### 公式 SDK（TypeScript）

SDK は Standard API（https://gateway.yir.ai）を呼び出してジョブの送信、待機、取得を行います。Go SDK もあります。 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: "ウミガメがサンゴ礁の上をゆっくり泳ぐ。カメラは横から滑らかに追いかけ、澄んだ水を通した日差しが甲羅の上に揺らめく模様を落とす",
  },
  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 互換 API

OpenAI SDK や new-api などのゲートウェイ向けの OpenAI Images と Sora Videos プロトコルです。チャットには対応していません。 https://yir.ai/docs/integrations/openai-compatibility

- OpenAI SDK の base_url: `https://gateway.yir.ai/openai/v1`
- new-api のチャネル Base URL（チャネルタイプ OpenAI）: `https://gateway.yir.ai/openai`
- モデル 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": "ウミガメがサンゴ礁の上をゆっくり泳ぐ。カメラは横から滑らかに追いかけ、澄んだ水を通した日差しが甲羅の上に揺らめく模様を落とす",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "seconds": "5"
  }'
```

## FAQ

### Kling 3.0 Omni に公式 API はありますか？

はい。Kling AI は自社の公式 API で Kling 3.0 Omni を提供しています。同じ仕様では、Yir 上のサードパーティチャネルの公開価格は公式より最大 20% 安く（上の表を参照）、1 つの Yir API キーですべて呼び出せます。

## ルール

- Authorization: Bearer $YIR_API_KEY で認証します。キーはサーバーの環境変数に置き、ブラウザのコード、ソース管理、プロンプト、ログには含めないでください。
- ジョブは非同期です。Job ID を保持し、終了状態まで待ってから結果を読み取り、失敗とキャンセルも処理してください。
- 安全にリトライするには、同じ冪等キーと同じリクエストを再利用してください。結果が不明なときにむやみに再送信しないでください。
- 結果の URL は一時的なものです。保存が必要な場合はファイルを別の場所にコピーしてください。

## リンク

- [クイックスタート](https://yir.ai/docs/getting-started/quickstart)
- [API リファレンス](https://yir.ai/docs/reference)
- [llms.txt](https://yir.ai/llms.txt)
