Kling Omni 動画を作成する

POST

kling

videos

omni-video

curl https://api.cometapi.com/kling/v1/videos/omni-video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "model_name": "kling-v3-omni",
      "prompt": "A paper boat drifts across a calm pond at sunrise.",
      "mode": "std",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": "off"
    }'

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "<task_id>",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": null
    },
    "task_status_msg": null,
    "created_at": 1773366840306,
    "updated_at": 1773366840306
  }
}

このエンドポイントは、CometAPI が提供する O1 互換の Kling Omni ワークフローで使用します。これには、テキストから動画への生成と、最初のフレーム画像を参照した生成が含まれます。

プロバイダーのパラメータに関する完全なリファレンスについては、Kling Omni Video documentation を参照してください。

入力モードを選択する

テキストから動画: prompt、mode、aspect_ratio、duration を送信します
最初のフレーム画像参照: image_url と type: first_frame を含む image_list 項目を追加し、その後 prompt 内で画像を <<<image_1>>> として参照します
ウォーターマーク付き出力: クエリレスポンスでウォーターマーク付き動画 URL が必要な場合は、watermark_info.enabled: true を追加します
Model ID: ルートのデフォルトを使用するには model_name を省略するか、kling-video-o1 や kling-v3-omni など、テスト済みの Omni Video model ID を送信します

長さとアスペクト比

Setting	Supported values	Default	Boundary behavior
テキストまたは最初のフレーム動画の `duration`	`"5"`, `"10"`	`"5"`	値は文字列として送信し、固定された 2 つの生成時間のいずれかを使用します。
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	最初のフレーム画像がフレームを制御しない場合に必須です。
`mode`	`std`, `pro`	route default	標準生成には `std` を送信し、選択したモデルが高品質モードをサポートしている場合にのみ `pro` を送信します。

Kling Omni は厳密な size フィールドを公開していません。aspect_ratio はフレーム形状の指定として扱ってください。16:9 のテキストから動画へのリクエストは、フル HD の 1920x1080 としてレンダリングされる場合があります。

タスクの流れ

Omni タスクを作成する

リクエストを送信し、返された task_id を保存します。

Omni タスクをポーリングする

タスクが完了するまで Kling Omni 動画を取得するを続けます。

完成した動画を保存する

永続的なアクセスが必要な場合は、返された MP4 URL を独自のストレージに移動します。

承認

Authorization

string

header

必須

Bearer token authentication. Use your CometAPI key.

ヘッダー

Content-Type

string

Content type of the request body.

ボディ

application/json

prompt

string

必須

Text prompt describing the desired video. Maximum length is 2,500 characters. When you send image_list, reference the image with <<<image_1>>>.

model_name

string

Optional model ID for this Kling Omni video request. Omit this field to use the route default.

image_list

object[]

Optional first-frame image reference for image-referenced Omni generation.

Show child attributes

sound

enum<string>

デフォルト:off

Whether to generate audio with the video. Use on or off.

利用可能なオプション:

on,

off

mode

enum<string>

Generation mode. Use std for standard generation or pro when the selected model supports the higher-quality mode.

利用可能なオプション:

std,

pro

aspect_ratio

enum<string>

Aspect ratio request for beta Kling Omni generation. The endpoint does not expose an exact size field; a 16:9 text-to-video request can render as 1920x1080.

利用可能なオプション:

16:9,

9:16,

1:1

duration

enum<string>

デフォルト:5

Requested output length for text-to-video and first-frame image-reference workflows. Use 5 or 10 as a string.

利用可能なオプション:

5,

10

watermark_info

object

Watermark options. When enabled is true, the task can return watermarked result URLs in addition to original result URLs.

Show child attributes

callback_url

string<uri>

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id

string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

レスポンス

200 - application/json

Success

code

integer

必須

Response code. 0 means the task request was accepted.

message

string

必須

Response message.

data

object

必須

Show child attributes

request_id

string

Request identifier returned by CometAPI when present.

Kling タスクを取得する

Kling Omni 動画を取得する

curl https://api.cometapi.com/kling/v1/videos/omni-video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "model_name": "kling-v3-omni",
      "prompt": "A paper boat drifts across a calm pond at sunrise.",
      "mode": "std",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": "off"
    }'

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "<task_id>",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": null
    },
    "task_status_msg": null,
    "created_at": 1773366840306,
    "updated_at": 1773366840306
  }
}

コンテンツモデレーション

APIキー

入力モードを選択する

長さとアスペクト比

タスクの流れ

承認

ヘッダー

ボディ

レスポンス

​入力モードを選択する

​長さとアスペクト比

​タスクの流れ

承認

ヘッダー

ボディ

レスポンス

入力モードを選択する

長さとアスペクト比

タスクの流れ