kling-3.0-omni API

正確なモデル ID kling-3.0-omni を使用します。モデル フィールドはこのページと正確に一致する必要があります。

サンプル出力kling-3.0-omniPOST /v1/videos5.0s

パラメータ: duration=5resolution=1080pratio=16:9

プロンプト： One continuous take, no cuts. A concrete rooftop at golden hour, the city low and hazy behind. A model in a chrome moulded dress stands still with arms down while loose fabric panels fly in from off frame, hundreds of them in coral, ultraviolet and bronze, and assemble around her into a vast sculpted train that keeps growing past the roof edge. The camera orbits her a full half turn at chest height and rises as the train forms. One hard low sun from the left, deep cool shadow on the right. Real weight and inertia, cloth snapping in the wind, no text.

このサンプルを作成したリクエスト

{
  "model": "kling-3.0-omni",
  "prompt": "One continuous take, no cuts. A concrete rooftop at golden hour, the city low and hazy behind. A model in a chrome moulded dress stands still with arms down while loose fabric panels fly in from off frame, hundreds of them in coral, ultraviolet and bronze, and assemble around her into a vast sculpted train that keeps growing past the roof edge. The camera orbits her a full half turn at chest height and rises as the train forms. One hard low sun from the left, deep cool shadow on the right. Real weight and inertia, cloth snapping in the wind, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

認証とエンドポイント

https://modelflare.dev/v1 で Modelflare API キーを使用します。ゲートウェイのエントリ ポイントは POST /v1/videos です。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

タスクの作成

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-3.0-omni",
    "prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot",
    "duration": "5", "mode": "std"
  }'

ポーリングとダウンロード

タスクIDを保存します。 GET /v1/videos/{task_id} をポーリングし、GET /v1/videos/{task_id}/content でダウンロードします。結果 URL は有効期限が切れている可能性があるため、速やかにファイルを転送してください。

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

リクエストメモ

Kling は、ファミリー固有の model_name、prompt、mode、duration、image_list、または contents / settings フィールドを使用します。ネイティブ JSON が保存され、転送されます。

リクエストパラメータ

Kling Omni/O1 は、model_name、prompt、およびメディア リストを使用します。 image_list、video_list、element_list、multi_shot、soundを組み合わせる場合は、各モデルの公式制約に従ってください。

フィールド	必須	注意事項
model_name	はい	kling-3.0-omni
prompt	条件付き	マルチショット無効時に必須
mode	いいえ	std / pro
aspect_ratio	条件付き	16:9 / 9:16 / 1:1
duration	いいえ	3～15秒（文字列）
image_list	いいえ	最初/最後のフレーム、シーン、またはスタイルの参照。 Omni/O1 では、モデル制限内で複数の項目を許可します
video_list	いいえ	ビデオ編集またはスタイルのリファレンス
element_list	いいえ	Kling 要素 ID。この統合では要素管理は提供されません
multi_shot	いいえ	マルチショットのストーリーボードを有効にする
sound	いいえ	同期音を発生するかどうか

入出力制限

Omni は、720p/1080p/4k、3 ～ 15 秒、画像/ビデオ/要素参照、および最大 6 つのストーリーボード ショットをサポートします。参照映像がある場合はsoundをオフにしてください。

文書化されたワークフローの例

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-3.0-omni",
    "prompt": "让图 1 中的人物在雨中向镜头挥手",
    "image_list": [{"image_url": "https://example.com/character.png"}],
    "duration": "5", "mode": "pro", "aspect_ratio": "16:9", "sound": "off"
  }'

参照ビデオ、要素、およびマルチショットの組み合わせは、このページの制限に従う必要があります。参照映像がある場合はsoundをオフにしてください。

エラーと失敗したタスク

無効なモデル パラメーターは、リクエスト ID を含む 4xx を返します。非同期タスクは、作成が成功した後に失敗することもあります。ポーリング応答からの error_code と error_message を最終タスク理由として使用します。異なる JSON 形式で同じリクエストを再試行しないでください。

サポート範囲

このページでは、Modelflare モデルの生成と編集呼び出しについて説明します。検索またはマップのエンリッチメント、音声管理、および要素ライブラリ管理は、このパブリック モデル呼び出しサーフェスの外部にあるリソース API であり、必須のリクエスト フィールドではありません。

価格設定と請求

動画秒単位課金モデルです。現在の顧客価格、参考定価、完全な仕様については、モデル価格ページを参照してください。

ノート

このページでは、Modelflare のパブリック インターフェイスについて説明します。ここに示されているフィールドと制限は現在の契約です。