Kling V4 Flash

2026-11-07 確認の APIMaster kling-v4-flash 仕様。チャネル 317 はテキスト、開始画像、参照、編集、延長に対応します。720p、24fps、3–20 秒のみで、Kling V4 とは別のモデルです。

Kling V4 Flash

エンドポイントと認証

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key

パラメーター

JSON と Authorization: Bearer YOUR_API_KEY を使用し、model=kling-v4-flash を指定します。prompt は開始画像 1 枚の場合のみ省略可能。duration/seconds は JSON 整数 3–20、既定 5。null は省略扱い、0 は拒否。両方指定するときは有効で同値が必要。編集で省略すると入力映像ストリームの長さを切り上げます。resolution は 720p のみ。aspect_ratio または別名 size は 16:9、9:16、1:1、21:9、参照のみ auto も可能。既定はテキスト 16:9、参照 auto、編集は入力に従います。画像生成と延長では空でない aspect_ratio/size を指定できません。audio は true、watermark は false のみ。

パラメーター	JSON 型	必須条件	既定値	用途と制約
model	string	必須	kling-v4-flash	常に kling-v4-flash。5 種類の操作で共通です。kling-v4 は別モデルです。
prompt	string	モードによる	—	映像、動き、変更内容を記述します。単一の開始画像の場合のみ省略可能です。@Image1、@Video1 は各配列の順にそれぞれ 1 から数えます。編集対象は @Video1 です。
duration	integer / null	任意	5	3–20 の JSON 整数秒、通常は 5 秒です。編集で両方の時間指定を省略すると入力映像ストリームの長さを切り上げます。延長では新規区間の長さです。null は省略、0・整数でない数値・数値文字列は拒否します。
seconds	integer / null	任意	—	duration の別名で同じ制約です。片方だけの指定を推奨します。両方指定する場合は有効かつ同じ値が必要で、不一致は 400 です。
resolution	string	任意	720p	720p のみです。出力の短辺が必ず 720px になるという意味ではありません。1080p や mode による画質選択は未対応です。
aspect_ratio	string	任意	モードによる	テキスト・参照・編集は 16:9、9:16、1:1、21:9 に対応し、auto は参照のみです。既定はテキスト 16:9、参照 auto、編集は入力に追従。開始画像と延長では空でない値を拒否し、空文字列は省略扱いです。
size	string	任意	—	aspect_ratio の互換別名です。解像度やピクセル数ではありません。同時指定時は一致が必要です。開始画像・延長では両方省略してください。
image_urls	string[]	モードによる	—	公開画像 URL 配列。auto では開始画像 1 枚のみです。画像のみの参照では reference を明示します。参照・編集は reference_image の画像と合計 10 枚まで。開始画像の別指定と混在させず、延長では画像を渡しません。
first_frame_image	string	モードによる	—	単一開始画像の公開 URL。image_urls の 1 件、または first_frame ロールとの三者択一です。幅・高さとも 300px 以上、比率 2:5–5:2 が必要です。必要なら事前に切り抜きます。
image_with_roles	{url, role}[]	モードによる	—	各要素に公開 URL の url と role が必須です。first_frame は単一開始画像、reference_image は参照・編集用です。終了・中間・キーフレームは非対応。参照画像は両画像フィールド合計 10 枚、動画と合計 15 件までです。
video_url	string	モードによる	—	edit/extend を明示して使う単一入力動画 URL で、video_urls と排他です。編集は MP4/MOV、映像ストリーム 3–20 秒、幅・高さ各 700–4553px。延長は最終フレームから新規区間のみ返します。タスク・会話 ID は指定できません。
video_urls	string[]	モードによる	—	参照動画は最大 5 件の MP4/MOV。各 3 秒以上、幅・高さ各 700–4553px、合計 20 秒以下です。edit/extend を明示すれば 1 件で video_url の代用も可能です。超過は切り詰めず拒否し、通常は参照モードを自動選択します。
omni_reference_task_type	string	任意	auto	auto は素材からテキスト・開始画像・参照を判定、reference は参照素材が必要です。edit/extend は動画 1 件が必要です。video_url だけの指定や auto の画像 2 枚は無効です。
audio_setting	string	任意	auto	動画を含む参照モード専用です。auto は音声を新規生成、origin は最初の参照動画の音を保持します。元に音声トラックがなければ出力にもありません。編集・延長・テキスト・画像のみ参照では省略します。
audio	boolean	任意	true	互換 boolean。省略または true のみで、false は拒否します。原音保持は対応モードの audio_setting を使用します。独立した参照音声は非対応です。
watermark	boolean	任意	false	互換 boolean。省略または false のみで、true は拒否します。入力の透かしを除去する機能ではありません。

認証情報を含まない公開 HTTP(S) 直リンクのみです。base64・ローカルパス・タスク ID は不可。画像形式やバイト上限は個別に公表されていません。100MiB は探査する参照・編集動画 1 件の読み取り上限で、共通アップロード上限ではありません。

モードと素材

操作	選択方法と必要素材	既定値・除外項目
テキスト生成	素材なし、prompt 必須、タイプは省略または auto。	5 秒・16:9、audio_setting なし。
開始画像生成	3 通りの表現から 1 つで開始画像 1 枚、prompt は任意。	5 秒、画像比率に追従。aspect_ratio/size と終了フレームは不可。
参照生成	reference + 画像、reference_image ロール、または video_urls。prompt 必須。	5 秒・auto。画像≤10、動画≤5、合計≤15。音声設定には動画が必要。
動画編集	edit + 動画 1 件、prompt 必須。参照画像は最大 10 枚。	時間は入力を切り上げ、比率も入力に追従。フレームロール/audio_setting は不可。
動画延長	extend + 動画 1 件、prompt 必須。	新規 5 秒。画像・比率変更/audio_setting は不可。編集・参照の最小寸法と最短時間の検査は対象外。

omni_reference_task_type は auto、reference、edit、extend。image_urls 1 枚、first_frame_image、または first_frame 役割 1 枚が開始画像です。複数画像には reference か reference_image 役割が必要で、auto の image_urls 2 枚は拒否します。video_urls は既定で参照、edit/extend 明示時はそのモード。video_url は edit/extend 必須で video_urls と排他。編集・延長は動画 1 本が必要です。編集は参照画像を追加可能、延長は画像/audio_setting を受け付けず、新しい区間だけ返します。元動画の公開 URL を使用し、タスク ID や会話 ID は入力しません。

認証情報を含まない公開 HTTP(S) 直リンクのみ。画像最大 10 枚、画像と参照動画合計 15 個。画像は 300×300 以上、比率 2:5–5:2。参照動画最大 5 本の MP4/MOV、各 3 秒以上、合計 20 秒以下。編集は 3–20 秒の 1 本で、幅と高さはそれぞれ 700–4553 ピクセル。ゲートウェイは 1 本最大 100 MiB を読み、コンテナーや音声ではなく映像トラックを測定します。この最小時間・寸法検査は延長元に適用しません。画像寸法は上流でも検査します。audio_setting=origin は最初の参照動画の音声を維持し、音声なしなら無音。auto は音声生成。動画付き参照でのみ使用可能。編集は音声を再生成します。音声 URL、終点・中間画像、キーフレーム、negative_prompt、mode、seed、複数シーンや人物・音声一覧は未対応。

出力ピクセル数とフレームレート

比率 / 操作	文書に記載された出力寸法	フレームレート
16:9	1280×720	24 fps
9:16	720×1280	24 fps
1:1	960×960	24 fps
21:9	1464×628	24 fps
開始画像生成	画像比率に追従、約 0.92MP。2:5 なら例として 604×1516。	24 fps

出力寸法と入力条件は別です。21:9 の高さ 628px は参照・編集の下限 700px を満たさないため、適合する入力を準備してください。延長はその下限の対象外です。出力は約 1 フレーム長くなる場合があります。

実行しない例

1. text

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. first_frame

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. reference_image

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. mixed_reference

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. reference_video

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. reference_video / origin

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. edit / duration

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. edit / default

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. extend

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

料金計算

公式の名目基本単価は出力 1 秒 $0.094（720P）、動画ありの課金 1 秒 $0.0628（720P-input）。テキスト、画像、画像だけの参照、延長は出力・新しい区間の秒数で計算。動画参照と編集は 出力 + max(入力, 出力)。入力映像トラックの長さを全て合算してから秒単位で切り上げます。入力 3.04 秒、出力 3 秒なら 3+max(4,3)=7 課金秒。ファイルに約 1 フレーム余分でも指定した整数出力時間を使用します。パッケージ割引とアカウント倍率は別で、現在のカードと最終消費ログが基準です。確定した生成失敗は予約額を返金。照会停止はキャンセルではなく、不明な通信タイムアウトで新規生成しないでください。

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

照会・エラー・安全な再試行

初回受付は HTTP 200、公開 task_id、queued。GET /v1/videos/{task_id} で queued/in_progress/completed/failed を照会し、一時的な unknown も処理します。url と metadata.url は Bearer 必須。GET /v1/videos/{task_id}/content でも取得可能。生成失敗は error.code=generation_failed と秘匿処理済みメッセージ、不正パラメーターは HTTP 400。Idempotency-Key は空白なしの可視 ASCII 8–128 文字。同じアカウント・キー・要求の再送は HTTP 202 で二重生成・予約せず、変更は 409。GET /v1/video-submissions/by-key は元キーの受付記録を読みます。accepted+task_ready=true なら task_id を照会し、pending/submitting や未準備なら待機。acceptance_unknown はキーを保持してサポートへ連絡し、自動再送しません。404 は未受付の証明ではありません。最低 30 日保持。ゲートウェイ保護であり上流の検索ではありません。最終料金は other.task_id に一致する消費ログで確認。タスク照会に最終請求の保証はありません。/v1/videos/quote は未対応。例は実行されません。URL を置き換え、新規操作ごとに新しいキーを使用します。

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}

APIMart · Kling V4 Flash · Kling AI