guides

Kling 4.0 Flash APIガイド:パラメータ、料金、コード

Poyo.ai Team
6 min read
Share:

要点

  • Kling 4.0 Flashは、Kling 4.0の高速・低コストなティアです。 テキスト、開始画像、参照から720pで3〜20秒のクリップを作り、既存の動画も編集できます。
  • 1つのモデルIDですべてのモードに対応。 POST /api/generate/submitに"model": "kling-4.0-flash"を送ります。含めるメディアによって、テキストから動画、画像から動画、参照から動画、編集のいずれかが選ばれます。
  • PoYoでの料金は出力1秒あたり$0.094(18.8クレジット)で、テキスト、画像、画像参照のジョブに適用されます。5秒のクリップは$0.47、10秒のクリップは$0.94です。動画を入力に使う場合は、課金対象の1秒あたり$0.063です。
  • 1つのキーで従量課金。 PoYoはFlashをサブスクリプション不要の従量課金クレジットで課金し、同じキーとリクエスト形式でKling 4.0、Gemini Omni、Veoも動かせます。
  • 結果は非同期で返ります。 task_idを保存し、GET /api/generate/status/{task_id}をポーリングするか、callback_urlを設定します。
  • Kling 4.0への切り替えは1語の変更だけ。 両モデルは同じリクエストフィールドを共有しており、Kling 4.0では1080p、30秒のクリップ、終了フレーム、マルチショットのプロンプトが加わります。

Kling 4.0 Flashの概要

PoYoのKling 4.0 Flash
開発元Kuaishou(Kling AI)
APIモデルIDkling-4.0-flash
モデルページ/ja/models/kling-4-0-flash
モードテキストから動画、画像から動画(開始フレーム1枚)、参照から動画、動画編集
クリップの長さ3〜20秒、整数秒。デフォルトは5秒
解像度720p(Klingによると8ビットSDR)
アスペクト比16:9(デフォルト)、9:16、1:1、21:9、auto
参照画像最大10枚、動画5本、被写体7つ、合計15個まで
入力動画の枠元動画、参照動画、被写体の動画の合計で最大20秒
プロンプトの長さ最大26,000文字
料金$0.094/秒 · 動画入力ありでは課金対象の1秒あたり$0.063

Kling 4.0 Flashとは?

Kling 4.0 Flashは、KuaishouのKling 4.0動画ファミリーの中で速度を重視したモデルです。Kling自身のガイドでは、頻繁な制作向けに「高速な生成と優れたコストパフォーマンス」を兼ね備えたモデルと説明されており、テキストから動画、画像から動画、Omni Referenceに対応した、720pで3〜20秒のクリップが挙げられています。上位のKling 4.0モデルは、PoYoで最大30秒・1080pに対応し、開始・終了フレームとマルチショットのプロンプトも使えます。

「Kling 4 Flash」と「Kling 4.0 Flash」は同じモデルです。PoYoでは、ページのスラッグがkling-4-0-flash、APIモデルIDがドット付きのkling-4.0-flashです。

最大解像度よりも量と納期が重要な場面でFlashを使いましょう。たとえば、SNS用のクリップ、冒頭のフックやフォーマットのテスト、商品のループ動画、プリビズ、最終レンダリング前の下書きです。

Kling 4.0 Flashの720pクリップ:日の差し込む木造の道場で組み手をする2人の武術家。PoYoのモデルページの例より。

1つのモデルID、4つのモード

PoYoはinput内のフィールドからモードを判定します。

モード送るもの補足
テキストから動画promptaspect_ratioを選ぶ
画像から動画画像1枚ちょうどのimage_urlspromptは任意。開始画像が構図を決める
参照から動画reference_image_urls、reference_video_urls、kling_elementsのいずれか、または組み合わせimage_urlsで任意の開始フレームを指定すると、画像10枚の上限に含まれる
動画編集video_url + prompt参照画像、最大4本の参照動画、被写体を追加可能。構図は元動画に合わせる

優先順位は固定です。video_urlがあれば編集、参照フィールドがあれば参照から動画、image_urlsだけなら画像から動画、プロンプトだけならテキストから動画が選ばれます。

リクエストパラメータ

modelとcallback_urlはトップレベルに置き、それ以外のフィールドはすべてinputの中に入れます。

フィールド型値と上限デフォルト
modelstringkling-4.0-flash必須
callback_urlstringタスクの完了時または失敗時にPOSTを受け取る公開URL—
promptstring1〜26,000文字。テキスト、参照、編集では必須、画像から動画では任意—
durationinteger3〜205。編集では元動画の長さ
resolutionstring720p720p
aspect_ratiostringauto、16:9、9:16、1:1、21:9(テキストと参照のモード)16:9
image_urlsarray開始画像1枚ちょうど—
reference_image_urlsarray最大10枚の画像—
reference_video_urlsarray最大5本の動画(編集では4本)、各3〜20秒—
kling_elementsarray最大7つの被写体。各被写体はelement_input_urls(2〜4枚の画像、正面からの画像を最初に)かelement_input_video_urls(3〜8秒の動画1本ちょうど)のどちらかを持つ。動画の被写体は最大3つ—
video_urlstring編集する元動画、3〜20秒—

送信前に確認しておきたい共通の上限:

  • 合計15個まで: 開始フレーム + 参照画像 + 参照動画 + 被写体。
  • 入力動画は合計20秒まで: 元動画 + 参照動画 + 動画の被写体。
  • タグは配列の順序に従う: @Image1、@Video1、@Element1。編集では元動画が@Video1になり、参照動画は@Video2から始まります。
  • Playgroundでのアップロード形式: MP4またはMOV、1本あたり最大200 MB。メディアのURLは、公開されたHTTPまたはHTTPSのリンクにしてください。

最初のリクエストを送信する

PoYoのダッシュボードでAPIキーを作成し、サーバー側で保管します。続いて、5秒のテキストから動画のタスクを送信します。

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4.0-flash",
    "input": {
      "prompt": "A ceramic mug of coffee steams on a wooden windowsill as rain streaks the glass. Slow push-in, soft morning light, clean frame free of text and logos.",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

送信に成功すると、code: 200と、data内のタスクが返ります。

{
  "code": 200,
  "data": {
    "task_id": "YOUR_TASK_ID",
    "status": "not_started",
    "created_time": "2026-11-14T10:30:00"
  }
}

バリデーションエラーはHTTP 200とcode: 400で返ることもあるため、HTTPステータスだけでなくcodeフィールドも確認してください。402は、アカウントにクレジットの追加が必要なことを示します。

そのほかのリクエスト例

開始フレーム1枚から画像から動画

{
  "model": "kling-4.0-flash",
  "input": {
    "image_urls": ["https://example.com/red-panda.png"],
    "prompt": "The red panda shakes the snow off its fur, then turns toward the camera. Slow push-in, shallow depth of field.",
    "duration": 5
  }
}

画像から動画の結果:雪の積もった竹の枝の上のレッサーパンダが、雪を振り払ってカメラのほうを振り向く。5秒、94クレジット。PoYoのモデルページの例より。

被写体を使った参照から動画

次の被写体には、正面と横からの画像を使っています。プロンプトでは、被写体を@Element1、場所の画像を@Image1として呼び分けています。

{
  "model": "kling-4.0-flash",
  "input": {
    "prompt": "@Element1 walks along the cliff-top path toward the lighthouse in @Image1 at golden hour. The camera tracks beside him as he stops and looks up at the lamp. Keep his face and yellow raincoat consistent with @Element1.",
    "reference_image_urls": ["https://example.com/lighthouse.png"],
    "kling_elements": [
      {
        "element_input_urls": [
          "https://example.com/keeper-front.png",
          "https://example.com/keeper-side.png"
        ]
      }
    ],
    "duration": 8,
    "aspect_ratio": "9:16"
  }
}

参照から動画の結果:場所の画像と2方向からの被写体をもとに作った、黄色いレインコートと赤いニット帽の灯台守が夕暮れの崖の小道を灯台に向かって歩く映像。8秒、9:16、150.4クレジット。PoYoのモデルページの例より。

既存のクリップを編集する

出力は、デフォルトで元動画の長さを保ちます。

{
  "model": "kling-4.0-flash",
  "input": {
    "video_url": "https://example.com/winter-clip.mp4",
    "reference_image_urls": ["https://example.com/spring-bamboo.png"],
    "prompt": "Edit @Video1 and change the season from winter to spring, using @Image1 as the environment reference. Keep the animal, its movements, timing and camera motion exactly as in @Video1."
  }
}

編集の結果:上の雪の中のレッサーパンダのクリップを、パンダの動きとカメラの動きはそのままに、緑の竹と桜が広がる春に変えた映像。151.2クレジット。PoYoのモデルページの例より。

タスクのステータスをポーリングする

タスクはいつでもIDで確認できます。

curl https://api.poyo.ai/api/generate/status/YOUR_TASK_ID \
  -H "Authorization: Bearer $POYO_API_KEY"

ステータスはnot_startedからrunning、そしてfinishedまたはfailedへと進みます。完了したタスクでは、data.filesにfile_urlとfile_type: "video"を持つ動画が並びます。失敗したタスクにはerror_messageが入ります。

バックエンド向けの、上限付きのPythonループ:

import os
import time
import requests

API = "https://api.poyo.ai"
HEADERS = {"Authorization": "Bearer " + os.environ["POYO_API_KEY"]}

def data_or_raise(resp):
    resp.raise_for_status()
    body = resp.json()
    if body.get("code") not in (0, 200):
        raise RuntimeError(body.get("message") or body)
    return body["data"]

task = data_or_raise(requests.post(f"{API}/api/generate/submit", headers=HEADERS, json={
    "model": "kling-4.0-flash",
    "input": {
        "prompt": "A paper lantern drifts up over a night market. Slow tilt up, warm light, glowing stalls below.",
        "duration": 5,
        "aspect_ratio": "9:16",
    },
}, timeout=60))
task_id = task["task_id"]
print("task:", task_id)

deadline = time.monotonic() + 20 * 60
while time.monotonic() < deadline:
    status = data_or_raise(requests.get(f"{API}/api/generate/status/{task_id}", headers=HEADERS, timeout=60))
    if status["status"] == "finished":
        print([f["file_url"] for f in status.get("files", []) if f.get("file_type") == "video"])
        break
    if status["status"] == "failed":
        raise RuntimeError(status.get("error_message") or "generation failed")
    time.sleep(10)
else:
    print("Still running; check this task_id again later:", task_id)

ループがタイムアウトした場合は、あとで同じtask_idをもう一度問い合わせてください。新たに送信すると、それは別のクリップとして課金されます。本番のパイプラインでは、トップレベルのcallback_urlを使えば、ポーリングの代わりにWebhookで受け取れます。

Kling 4.0 Flashのクリップ1本あたりのコスト

PoYoはFlashを、従量課金のクレジット($1 = 200クレジット)で秒単位に課金します。テキスト、画像、画像参照のジョブでは、出力の長さに一律の料金がかかり、参照画像と画像の被写体は料金に含まれます。

出力の長さクレジット米ドル
3秒56.4$0.282
5秒94$0.47
8秒150.4$0.752
10秒188$0.94
15秒282$1.41
20秒376$1.88

比較すると、Kling 4.0で同じ5秒のクリップを720pで作ると$0.7125なので、Flashは約34%安くなります。

動画入力がある場合

リクエストに元動画、参照動画、動画の被写体が含まれる場合、料金は課金対象の1秒あたり12.6クレジット($0.063)で、課金対象の秒数は次のとおりです。

課金対象の秒数 = 出力の長さ + max(入力動画の合計の長さを切り上げた値, 出力の長さ)

ジョブ課金対象の秒数クレジット米ドル
4秒の参照動画1本をガイドにした5秒のクリップ5 + max(4, 5) = 10126$0.63
合計12秒の参照動画をガイドにした10秒のクリップ10 + max(12, 10) = 22277.2$1.386
8秒のクリップを長さを変えずに編集8 + max(8, 8) = 16201.6$1.008
15秒のクリップを5秒の参照動画1本で編集15 + max(20, 15) = 35441$2.205

入力の長さの端数は切り上げられます。モデルページの春の編集例では、元動画が5秒を少し超えていたため6秒として数えられ、6 + 6 = 12秒の課金、つまり151.2クレジットになりました。Kling 4.0ファミリー全体の予算の立て方は、Kling 4.0 API料金ガイドをご覧ください。

Kling 4.0 Flashのプロンプトのコツ

  1. 1クリップに1つの連続した動作。 短いクリップは、プロンプトが1つの被写体の1つの流れ(「振り向き、立ち止まり、見上げる」)を追うときに最も安定します。複数の展開があるストーリーは10〜20秒のクリップに回し、導入、行動、結末の順に書きましょう。
  2. カメラの動きを明記する。 プッシュイン、オービット、トラッキングショット、ティルトアップなど。視覚的な描写と区別できるよう、独立した1文にします。
  3. 光と質感を描写する。 時間帯、光の向き、濡れたガラス、ヘアライン加工の金属、毛皮などの素材を書くと、720pのクリップでもはっきりした一貫性のある見た目になります。
  4. すべての入力にタグを付ける。 配列の順に@Image1、@Video1、@Element1と呼び、それぞれが何を決めるのか(人物、場所、動き、スタイル)を書きます。
  5. 被写体は丁寧に作る。 正面からの画像を最初に置き、別の角度を1〜3枚加え、背景はシンプルにします。動画の被写体には、はっきりした3〜8秒のクリップを1本使います。
  6. 編集は「Edit @Video1」で始める。 そのあとで変更点を書き、人物、動き、タイミング、カメラの軌道など、変えずに残すものを列挙します。
  7. すっきりした画面を指定する。 あとでキャプションやブランド要素を加える予定なら、「clean frame, free of text and logos」(文字やロゴのないすっきりした画面)と書き添えます。
  8. 長さはアイデアに合わせる。 5秒のクリップは1つのしぐさや見せ場に合っています。コストは1秒ごとに増えるため、15〜20秒は長さが必要な動作に使いましょう。

Kling 4.0 Flashでのカメラワークの指定:ネオンの下、煙の中をドリフトするレーシングカーの周りをカメラが回り込み、最後に車の正面で止まる。PoYoのモデルページの例より。

ファミリー全体で使えるプロンプトのパターンは、Kling 4.0プロンプトガイドとOmni Referenceガイドをご覧ください。

Kling 4.0 FlashとKling 4.0の簡単な比較

Kling 4.0 FlashKling 4.0
モデルIDkling-4.0-flashkling-4.0
解像度720p720p、1080p
クリップの長さ3〜20秒3〜30秒
フレーム開始フレーム1枚開始フレームと終了フレーム
マルチショットのプロンプト1クリップに1つのプロンプトショットごとの長さを指定できるmulti_prompt
編集での参照画像、最大4本の参照動画、被写体画像と画像の被写体
720pの料金、テキストと画像のジョブ$0.094/秒$0.1425/秒

下書きはFlashで作り、最終カットに1080p、終了フレーム、20秒を超える長さが必要になったら、選んだ方向性をKling 4.0に移しましょう。詳しい比較はKling 4.0とFlashの比較をご覧ください。FlashとGoogleの高速動画モデルとの比較は、Gemini Omni 1.2 Flash、Kling 4.0 Flash、Veo 3.1の比較をご覧ください。

よくある質問

Kling 4.0 FlashのモデルIDは何ですか?

kling-4.0-flashです。URLにはページのスラッグkling-4-0-flashが使われます。リクエストボディには"model": "kling-4.0-flash"を指定してください。

Kling 4.0 Flashの料金はいくらですか?

PoYoでは、テキスト、画像、画像参照のジョブで出力1秒あたり18.8クレジット($0.094)です。5秒なら$0.47、10秒なら$0.94、20秒なら$1.88になります。動画を入力に使う場合は、課金対象の1秒あたり12.6クレジット($0.063)です。

Kling 4 Flashは無料で使えますか?

PoYoのKling 4.0 Flashは、サブスクリプション不要の従量課金クレジットで動きます。実行ごとにクレジット残高から課金され、Playgroundでは生成前にクレジットの見積もりが表示されるので、プロンプト、参照のセット、編集のコストを先に確認できます。

Kling 4.0 Flashの動画はどのくらいの長さにできますか?

1回の生成で3〜20秒、整数秒で指定します。デフォルトは5秒で、編集ではdurationを指定しない限り元動画の長さを保ちます。

FlashからKling 4.0に移るのはどんなときですか?

Flashは、プロンプト、開始フレーム、参照から720pのクリップを作るためのモデルです。1080p、終了フレーム、multi_prompt、最大30秒のクリップが必要なら、同じリクエストフィールドのままKling 4.0を使いましょう。

Kling 4.0 FlashはKling 4.0より速いですか?

KlingはFlashを、頻繁な制作と素早い反復のための高速なティアと説明しています。生成時間はクリップの長さとその時点の負荷によって変わるため、自分のプロンプトをいくつか試して時間を計ってみてください。

同じキーでほかの動画モデルも使えますか?

はい。Kling 4.0 Flashを動かすPoYoのキーで、Kling 4.0、Gemini Omni 1.2 Flash、Veo 3.1などのモデルも、同じ送信とステータスのエンドポイント、1つのクレジット残高で利用できます。

動画の準備ができたらWebhookで受け取れますか?

はい。トップレベルにcallback_urlを追加すると、タスクの完了時または失敗時にPoYoがそのURLにPOSTを送ります。同じtask_idで、いつでもステータスのエンドポイントに問い合わせることもできます。

Share: