Kling 4.0 動画編集
kwaivgi/kling-v4.0/video-edit
プロンプトと任意の参照画像で動画を編集します。720p・1080pに対応し、元の音声を初期設定で保持します。
サンプル
パラメータ
| 名前 | 型 | 既定 | 制約 | 説明 |
|---|---|---|---|---|
| prompt *プロンプト | textarea | — | ≤ 5000 chars | 動画に適用したい編集内容を説明してください。被写体、背景、天気、スタイルなどを変更できます。プロンプト内では動画を @Video1、参照画像を配列順に @Image1、@Image2… として指定してください。 |
| images参照画像 | image_upload | — | image/* · 0–10 items | 編集に取り入れたい被写体、物体、またはスタイルのための参照画像です(任意、最大 10 枚)。 |
| keep_original_sound元の音声を保持 | boolean | true | — | 元動画の音声を保持します。オフの場合は映像に同期する新しい音声を生成します。 |
| resolution解像度 | select | 720p | 720p | 1080p | 出力解像度。 |
| duration長さ | select | — | 3 ~ 30 · step 1 · 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | … | 出力時間は 3〜30 秒の整数です。省略すると元動画に合わせます(最大 30 秒)。 |
| aspect_ratioアスペクト比 | select | — | 16:9 | 9:16 | 1:1 | 21:9 | 出力動画のアスペクト比。省略すると元動画に合わせます。 |
出力フィールド
| フィールド | 型 | 説明 |
|---|---|---|
| videos | array<string> |
API
統一 REST API でこのモデルを呼び出せます。API Keys ページでキーを取得してください。
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-v4.0/video-edit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"keep_original_sound": true,
"resolution": "720p"
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-v4.0/video-edit",
headers=HEADERS,
json={
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"keep_original_sound": True,
"resolution": "720p"
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 1800s server-side.
deadline = time.time() + 1860
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-v4.0/video-edit", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"keep_original_sound": true,
"resolution": "720p"
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 1800s server-side.
const deadline = Date.now() + 1860 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);ドキュメント
Kling 4.0 · 動画編集
テキスト指示と任意の参照画像で既存の動画を編集します。変更したい内容と、維持したい動きや構図を指定してください。
入力パラメーター
- prompt:文字列、必須。
- video:必須の単一動画URL文字列。配列ではありません。元動画は3秒以上必要で、30秒を超える部分は切り詰められます。
- images:任意の画像URL配列、最大10枚。
- keep_original_sound:ブール値、既定はtrue。falseにすると新しい同期音声を生成します。
- resolution:"720p"(既定)または"1080p"。
- duration:任意の3〜30の整数。省略時は入力時間を秒単位で切り上げ、上限30秒として使用します。5秒の固定既定値はありません。
- aspect_ratio:任意で"16:9"、"9:16"、"1:1"、"21:9"。省略すると元動画に従います。"auto"は送信しないでください。
制限と参照方法
元動画は@Video1で参照します。@Image1、@Image2以降はimages配列順です。このAPIはvideos配列や参照音声のアップロードを受け付けません。
通常料金と事前のクレジット計算
課金対象の1秒あたり、720pは$0.094、1080pは$0.141です。
出力秒数をD、V = ceil(min(入力動画の合計秒数, 30))とします。入力動画がある場合、料金 = 単価 × (D + max(D, V))です。720p、出力5秒、入力8.2秒の場合はV=9、料金は$1.316、事前の請求額は131.60クレジットになります。
durationを省略した場合はD=Vです。D=V=5なら720pで$0.94、1080pで$1.41です。出力1秒あたり$0.188/$0.282という等長時の料金を、入力のほうが長い場合にそのまま使用しないでください。
1 USD = 100 Namiクレジット。合計を0.01クレジット単位で切り上げます:クレジット = ceil(USD料金 × 10000) / 100。通常料金を使用し、期間限定割引は適用しません。
参照画像、アスペクト比、元音声の保持設定に個別の追加料金はありません。
MaaS へのマッピング
videoはMaaSでも単一文字列、imagesは配列です。入力に従う場合は、durationとaspect_ratioを省略した状態で渡します。 その他の記載フィールドはMaaSでも同名です。durationは整数、対応するAPIのkeep_original_soundはブール値で送信します。配列の順序は維持されます。
Nami API
Authorization: Bearer YOUR_NAMI_API_KEY と Content-Type: application/json を指定し、次のURLへPOSTします。
https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-v4.0/video-edit
リクエスト本文の例:
{
"input": {
"video": "https://example.com/source-video.mp4",
"images": [
"https://example.com/jacket-reference.jpg"
],
"prompt": "Change the jacket in @Video1 to match @Image1. Preserve the original subject motion, camera movement and background.",
"keep_original_sound": true,
"resolution": "720p"
}
}
example.com のURLは公開アクセス可能な素材URLに置き換えてください。返されたtask_uuidを使い、同じ認証で GET https://www.namifusion.com/api/v1/marketplace/run/tasks/{task_uuid} をポーリングします。成功後、生成された動画URLの配列を output.videos から取得します。
関連モデル
VT Lip Sync 口形同期
VT Lip Sync は、翻訳後の対象動画、翻訳後音声、翻訳後字幕タイミング、および元動画とその元字幕タイミングを使用して、翻訳後動画の口形を同期します。
Kling Omni Video O3
Kling Omni Video O3は、複数の視点からキャラクター、プロップ、またはシーンの参照を使用して創造的な動画を生成します。対象の特徴を抽出し、フレーム間でアイデンティティの一貫性を維持しながら新しい動画コンテンツを作成します。音声生成をサポート。すぐに使える REST API、最高のパフォーマンス、コールドスタートなし、手頃な価格。
Kling Omni Video O3
Kling Omni Video O3は、複数の視点からキャラクター、プロップ、またはシーンの参照を使用して創造的な動画を生成します。対象の特徴を抽出し、フレーム間でアイデンティティの一貫性を維持しながら新しい動画コンテンツを作成します。音声生成をサポート。すぐに使える REST API、最高のパフォーマンス、コールドスタートなし、手頃な価格。
Kling 3.0 Standard モーションコントロール
Kling 3.0 Standard モーションコントロールは、参照動画の動きを静止画像に転送してアニメーション化します。キャラクター画像とモーションクリップ(ダンス、アクション、ジェスチャー)をアップロードすると、モデルが動きを抽出して滑らかでリアルな動画を生成します。すぐに使用可能な REST 推論 API、最高のパフォーマンス、コールドスタートなし、手頃な価格。
seedance-2-0 reference-to-video
Seedance 2.0の「リファレンス動画生成」機能は、ビジュアルの統一性を保つ究極のソリューションです。参考素材からアートスタイル、ライティング、構図の意図を正確に抽出。新しく生成される動画に完璧に融合させ、シリーズ作品を通して一貫した世界観を維持します。
black-forest-labs/flux-3/video-upscale 動画アップスケール
既定 creativity=1 は $0.79/秒から、creativity=0 は $0.55/秒。入力動画の長さを秒単位で切り上げて課金します。FLUX Video Upscale は、MP4 動画を高精細化し、元映像に忠実なディテール再現から創造的なディテール強調まで対応します。1.5x〜3x の拡大倍率を設定でき、動画修復、SNS コンテンツ、広告、制作ワークフローにおいて映像の鮮明さを向上させます。すぐに使える REST 推論 API、優れたパフォーマンス、コールドスタートなし、手頃な価格。
black-forest-labs/flux-3/video-extend-draft 動画延長
FLUX 3 Video Extend Draft は、必須の入力動画をもとに、プロンプトで次のシーンの動きを指定したドラフトクリップをすばやく生成します。同期した音声の生成は任意で、長さは 5〜20 秒から柔軟に選べるため、素早い反復作業に適しています。
black-forest-labs/flux-3/video-extend 動画延長
FLUX 3 Video Extend は、入力動画を新しい 5〜20 秒のクリップへ自然に延長し、プロンプトによって次の動き、カメラモーション、映像スタイル、動きの連続性、さらに必要に応じて同期した音声を制御できます。720P / 1080P 出力に対応。すぐに使える REST 推論 API を提供し、高性能・コールドスタートなし・手頃な価格で利用できます。