Omni 動画生成

feature_video は動画の特徴と動きのリズムを参照し、base_video は既存動画を編集します。画像・動画・エレメント・音声は合計最大 15 件で、各素材の制限も満たす必要があります。エレメントと音声には既存 ID を使用します。本ページには素材管理 API は含まれません。

POST/kling/omni-video/kling-4.0

プロンプト、画像、動画、エレメント、音声を組み合わせて動画を生成・編集します。feature_video は動画参照、base_video は編集用です。Omni は他の二つの生成 API と同じ Kling 4.0 モデルを使用します。

認証

bearerAuth

認証Bearer <token>

プラットフォームの API Key を使用：Authorization: Bearer your-api-key。

指定位置: header

リクエストボディ

application/json

TypeScript 型定義

TypeScript で request body 型を使用します。

contents*array<||||>

プロンプトと任意の参照素材。画像・動画・エレメント・音声は合計 15 件以下で、各素材の制限も満たしてください。

項目数1 <= items

settings?

options?

レスポンスボディ

`application/json`

curl -X POST "https://api.agtcloud.cn/kling/omni-video/kling-4.0" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "type": "prompt",
        "text": "@scene の場面の雰囲気を参考に海岸の空撮動画を生成する。"
      },
      {
        "type": "refer_image",
        "id": "scene",
        "url": "https://example.com/scene.jpg"
      }
    ],
    "settings": {
      "duration": 5,
      "resolution": "1080p",
      "aspect_ratio": "adaptive"
    }
  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "id": "123456789012345678",
    "status": "submitted",
    "message": "",
    "create_time": 1792713600000,
    "update_time": 1792713600000
  }
}

素材の型と参照

contents にはプロンプト項目 type: "prompt" が必要です。他の素材は必要に応じて追加します。id はプロンプト内の @reference に使用し、素材参照 ID は同一タスク内で重複できません。

素材	`type`	入力と必須項目
画像	`first_frame` / `middle_frame` / `last_frame` / `refer_image`	`url` 必須。URL または Base64。`id` 任意
動画	`feature_video` / `base_video`	`url` 必須。動画 URL。`id` 任意
エレメント	`element`	`element_id` と `id` が必須
音声	`voice`	`voice_id` と `id` が必須

element_id はエレメント関連 API から取得するシステム生成 ID、voice_id は音声 ID です。カスタム音声は音声カスタマイズ API から取得し、公式のプリセット音声も使用できます。これらは本リクエスト内の素材参照 id とは別のパラメータです。

エレメントの概念と使い方は公式エレメントライブラリガイド、音声の取得元は公式音声カスタマイズ説明を参照してください。対応するリージョンの素材 ID を使用し、別リージョンのプリセット ID は流用しないでください。

素材の制限

素材	形式・サイズ	寸法・長さ・件数
画像	JPG、JPEG、PNG。1 枚最大 30MB	幅・高さとも 300px 以上、比率 2:5～5:2、最大 10 枚
動画	MP4、MOV。1 ファイル最大 300MB	各動画・入力合計とも 3～30 秒。幅・高さ 700～4553px、総画素 8294400 以下。比率 2:5～5:2。入力 24～60fps、出力 24fps
エレメント	複数画像・動画キャラクターエレメント	最大 7 件、うち動画キャラクターは最大 3 件
音声	既存カスタム音声・システムプリセット音声	最大 3 件

組み合わせ時は次の条件も満たす必要があります：

画像・動画・エレメント・音声は合計 15 件以下。
動画と動画キャラクターエレメントは合計 5 件以下。base_video は最大 1 本。
入力動画の総時間には feature_video、base_video、動画キャラクターエレメントの元動画が含まれます。

よくあるエラーと対処

レスポンス・エラー	確認と対処
HTTP 401、`Invalid token`	Bearer 形式と API Key の所属サイトを確認
HTTP 400、`contents cannot be empty`	空でない `contents` 配列を指定
HTTP 400、`prompt cannot be empty`	`contents` に空でない `type: "prompt"` のテキスト項目を追加
HTTP 400、`contents[0].type ... is invalid`	本ページの素材型とエラーのインデックスを確認
HTTP 400、`Invalid element id`	`element_id` を確認。素材参照 `id` をエレメント ID の代わりに使用しない
HTTP 400、`Invalid voice id`	`voice_id` を確認。素材参照 `id` を音声 ID の代わりに使用しない
HTTP 400、`invalid JSON request body`	JSON の引用符・カンマ・括弧・コメントを確認

HTTP 400 は code/message/data または error オブジェクトで返る場合があります。fail_to_fetch_task の原因は message にあり、code/message/request_id を含む JSON 文字列の場合があります。リクエスト ID を保存し、API Key は提供しないでください。

認証

リクエストボディ

レスポンスボディ

200application/json

400application/json

401application/json

素材の型と参照

素材の制限

よくあるエラーと対処

`application/json`

`application/json`

`application/json`