kling-video

Name: kling-video
Author: acedatacloud

github.com/acedatacloudクリエイティブ・メディア17232 回インストール今日更新

リポジトリ

kling-video について

kling-videoは、AceDataCloudのKuaishou Kling APIで動画を生成・編集するスキルです。テキストや画像からの生成に加え、参照素材、モーション制御、リップシンク、トーキングフォトに対応します。

主な機能

01テキストからの動画生成と画像アニメーション
02画像・動画の参照入力
03動画延長とモーション制御
04リップシンクとトーキングフォト
05複数のモデルと品質モード

活用シーン

01文章で指定したシーンから動画を生成
02開始・終了画像を使って静止画を動かす
03参照動画の動きを被写体に適用
04リップシンク動画や動くポートレートを作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/acedatacloud/skills --skill kling-video

インストール後、Claude Code で/kling-videoを入力して読み込まれたか確認します。

詳細

Kling 動画生成

AceDataCloud の Kuaishou Kling API を使用して AI 動画を生成します。

初回セットアップ

clawhub install @acedatacloud/kling で公式 Skill をインストールします。ClawHub の公開者が @acedatacloud であることを確認してください。
AceDataCloud → Applications にサインインし、General application を開いて、Kling の利用権限、残高、現在の料金を確認します。API キーをコピーするか、別のキーを作成するには Manage Keys → Create を選択します。Bearer を含めずにキーの値をコピーしてください。platform-... で始まる管理用トークンは、サービス API キーではありません。
Allowed APIs の制限を有効にする場合は、/kling/videos と /kling/tasks を含めてください。以下の高度なワークフローでは、追加のルートを呼び出す場合があります。
OpenClaw Gateway のホストで、ACEDATACLOUD_API_TOKEN=your_api_key_here を ~/.openclaw/.env に設定し、Gateway を再起動して新しいセッションを開始します。ターミナルから直接テストする場合は、そのシェルで export ACEDATACLOUD_API_TOKEN="your_api_key_here" を実行します。キーをプロンプトに記載したり、.env ファイルをコミットしたりしないでください。
以下の クイックスタート を実行します。このワークフローからタスク ID が返された場合は、同じタスクが完了するまで照会してください。進捗を確認するためだけに、同じ課金対象のリクエストを再送信しないでください。

キーのセットアップ、初回実行、トラブルシューティングの図解 · トークンの詳細

クイックスタート

curl -X POST https://api.acedata.cloud/kling/videos \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "text2video", "prompt": "a cat playing piano on a rooftop at sunset", "model": "kling-v3", "mode": "std", "duration": 5}'

非同期： 非同期タスクのポーリングを参照してください。{"id": "..."} を指定して POST /kling/tasks でポーリングします。

モデル

モデル	品質	最適な用途
`kling-v3-turbo`	高速	720p／1080p、整数で 3～15 秒、オフにできないネイティブ音声を含む
`kling-v3`	最新	最高品質、柔軟な 3～15 秒の長さ、音声生成は任意
`kling-v3-omni`	最新	音声に加えて画像／動画を参照できる V3 Omni モデル、柔軟な 3～15 秒の長さ
`kling-v2-6`	高品質	音声を任意で含められる高品質な出力（pro モード）
`kling-v2-5-turbo`	高品質＋高速	速度と品質のバランスに優れる
`kling-v2-master`	高品質	高品質な出力
`kling-v2-1-master`	高品質	v2 を改良
`kling-v1-6`	改良版	v1 より高品質
`kling-v1`	標準	基本的な生成、最も低コスト
`kling-o1`	プレミアム	画像／動画を参照できる独立した O1 モデル、5 秒のみ

品質モード

モード	速度	コスト	用途
`std`（標準）	遅い	低い	下書き／プレビュー
`pro`（プロフェッショナル）	速い	高い	最終出力
`4k`（ネイティブ 4K）	—	プレミアム	ネイティブ 4K 出力 — `kling-v3` と `kling-v3-omni` のみ対応。`camera_control` とは併用できません

ワークフロー

1. テキストから動画へ

POST /kling/videos
{
  "action": "text2video",
  "prompt": "a futuristic city with flying cars",
  "model": "kling-v3",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}

2. 画像から動画へ

静止画像にアニメーションを付けます。必要に応じて終了フレームを指定します。

POST /kling/videos
{
  "action": "image2video",
  "prompt": "the scene slowly comes alive with movement",
  "start_image_url": "https://example.com/scene.jpg",
  "end_image_url": "https://example.com/end-scene.jpg",
  "model": "kling-v3",
  "mode": "pro"
}

3. Omni 参照

kling-o1 または kling-v3-omni で、参照画像や参照動画を 1 つ使用します。プロンプト内で、それぞれの項目を 1 始まりのトークンを使って指定してください。

POST /kling/videos
{
  "action": "text2video",
  "prompt": "turn <<<video_1>>> into hand-painted animation while preserving its motion",
  "model": "kling-o1",
  "mode": "std",
  "duration": 5,
  "generate_audio": false,
  "video_list": [
    {
      "video_url": "https://example.com/source.mp4",
      "refer_type": "base",
      "keep_original_sound": "no"
    }
  ]
}

スタイル、動き、または隣接するショットを参照するには refer_type: "feature" を使用します。指定した動画を編集するには refer_type: "base"（デフォルト）を使用します。ベース動画と最初／最後のフレームは併用できません。

参照動画の課金

送信前に、モデル、モード、参照入力の現在の料金を確認してください。kling-o1 と kling-v3-omni では、video_list に動画を指定すると、別料金の参照動画料金が適用されます。image_list、開始フレーム、終了フレームのみでは適用されません。参照動画を使用する場合は、generate_audio=false に設定してください。
参照動画を使用するリクエストが成功した場合、std は課金対象の秒数あたり 1.202 Credits、pro は課金対象の秒数あたり 1.602 Credits です。比較として、kling-o1 に5秒のリクエストを送信した場合の料金は次のとおりです。

モード参照動画なし課金対象の参照動画が5秒の場合
std 4.005 Credits 6.010 Credits
pro 5.340 Credits 8.010 Credits
refer_type=base の場合、編集後の長さは参照クリップの長さに従うことがあります。最終的な課金額は実際の出力時間を整数秒に切り上げて算出されます（5.708s は6s分、5.041s は5s分として課金されます）。refer_type=feature の場合、課金には指定した duration が使用されます。base 編集が指定時間ちょうどの秒数分として課金されるとは限りません。
同じタスクの完了までポーリングし、返された usage.reference_video_seconds を確認して、最終的な課金対象の秒数を把握してください。完了後の使用量と課金記録を照合してください。送信時の見積もりと最終請求額は異なる場合があります。実際に返された使用量のみを報告し、作り上げた応答や結果 URL の数から推測した料金は報告しないでください。

4. 動画の延長

既存の動画に秒数を追加して続けます。

POST /kling/videos
{
  "action": "extend",
  "video_id": "existing-video-id",
  "prompt": "the camera pulls back to reveal the full landscape",
  "model": "kling-v2-5-turbo"
}

5. モーションコントロール

画像と参照動画から、カメラや動きを精密に制御します。

POST /kling/motion
{
  "image_url": "https://example.com/subject.jpg",
  "video_url": "https://example.com/motion-reference.mp4",
  "mode": "std",
  "character_orientation": "image"
}

6. リップシンク

ソース動画と音声トラックまたは入力テキストから、リップシンク動画を作成します。

POST /kling/lip-sync
{
  "video_url": "https://example.com/source.mp4",
  "mode": "audio2video",
  "audio_url": "https://example.com/voiceover.mp3"
}

7. トーキングフォト

画像と音声トラックから、静止したポートレートに動きを付けます。

POST /kling/talking-photo
{
  "image_url": "https://example.com/portrait.jpg",
  "audio_url": "https://example.com/voiceover.mp3",
  "model": "kling-v2-1-master",
  "duration": 5,
  "mode": "pro"
}

パラメーター

パラメーター	値	説明
`action`	`"text2video"`, `"image2video"`, `"extend"`	生成モード
`model`	モデル一覧を参照	使用するモデル
`prompt`	文字列	生成または続行の指示（必須）
`mode`	`"std"`, `"pro"`, `"4k"`	品質モード（`4k` は `kling-v3` / `kling-v3-omni` のみ対応し、`camera_control` とは併用できません）
`duration`	O1: `5`; v3/v3-omni/v3-turbo: 整数 `3`–`15`; その他: `5`, `10`	秒単位の長さ
`start_image_url`	URL	`action=image2video` の必須の最初のフレーム
`end_image_url`	URL	`image2video` の任意の最後のフレーム。`start_image_url` が必要です
`video_id`	文字列	`action=extend` で必要な既存の Kling 動画 ID
`generate_audio`	`true`, `false`	v3、v3-omni、v2-6 pro で任意の音声を生成します。Turbo には常に音声が含まれます。このフィールドを省略するか、`true` を指定してください
`aspect_ratio`	`"16:9"`, `"9:16"`, `"1:1"`	動画のアスペクト比
`cfg_scale`	0–1	プロンプトへの関連度の強さ
`negative_prompt`	文字列	動画で避ける内容
`camera_control`	オブジェクト	カメラの動きのパラメーター
`image_list`	配列	`kling-o1` / `kling-v3-omni` 用の Omni 参照画像。各項目には `image_url` と任意の `type`（`first_frame` / `end_frame`）を指定します。参照動画がない場合は最大 7 枚、ある場合は最初と最後のフレームを含めて最大 4 枚です
`video_list`	配列	`kling-o1` / `kling-v3-omni` 用の Omni 参照動画（MP4/MOV を 1 本。3～10 秒、720～2160px、24～60fps、≤200MB）。各項目には `video_url`、`refer_type`（`feature` / `base`）、`keep_original_sound`（`yes` / `no`）を指定します
`callback_url`	文字列	非同期コールバック URL
`mode` (`/kling/lip-sync`)	`"audio2video"`, `"text2video"`	リップシンクモード
`video_url` (`/kling/lip-sync`)	URL	リップシンクの元動画 URL
`video_id` (`/kling/lip-sync`)	文字列	リップシンクに使用する既存の Kling 動画 ID
`audio_url` (`/kling/lip-sync`)	URL	音声ソース URL（`audio2video` 用）
`audio_type` (`/kling/lip-sync`)	`"url"`, `"file"`	音声入力の種類（デフォルトは `url`）
`audio_file` (`/kling/lip-sync`)	文字列	`audio_type=file` の場合の音声ファイルのペイロード
`text` (`/kling/lip-sync`)	文字列	音声合成する入力テキスト（`text2video` 用）
`voice_id` (`/kling/lip-sync`)	文字列	`text2video` で使用する音声プリセット ID
`voice_language` (`/kling/lip-sync`)	`"zh"`, `"en"`	`text2video` の TTS 言語（デフォルトは `zh`）
`voice_speed` (`/kling/lip-sync`)	数値	TTS の話速（デフォルトは `1.0`）
`mode` (`/kling/motion`)	`"std"`, `"pro"`	モーション生成の品質モード
`character_orientation` (`/kling/motion`)	`"image"`, `"video"`	キャラクターの向きの参照元
`image_url` (`/kling/talking-photo`)	URL	元となるポートレート画像
`audio_url` (`/kling/talking-photo`)	URL	動きを付ける音声トラック
`model` (`/kling/talking-photo`)	`"kling-v1"`, `"kling-v1-6"`, `"kling-v2-master"`, `"kling-v2-1-master"`, `"kling-v2-5-turbo"`, `"kling-v2-6"`	トーキングフォトモデル
`duration` (`/kling/talking-photo`)	`5`, `10`	トーキングフォトの長さ
`mode` (`/kling/talking-photo`)	`"std"`, `"pro"`	トーキングフォトの品質モード

注意点

kling-o1 がサポートするのは duration=5 のみです。kling-v3 と kling-v3-omni は柔軟な 3～15 秒に対応し、その他のほとんどのモデルは 5 または 10 に対応します。
mode=4k が利用できるのは kling-v3 と kling-v3-omni のみで、camera_control とは併用できません。
generate_audio を有効にすると、kling-v3、kling-v3-omni、および kling-v2-6 pro で任意の同期音声を利用できます。Turbo には音声が含まれているため、false は指定できません。
end_image_url は image2video アクション専用で、最後のフレームを定義します。
Omni リファレンスに対応しているのは kling-o1 と kling-v3-omni のみです。<<<image_N>>> / <<<video_1>>> の形式で指定してください。
Omni リファレンスのリクエストでは、negative_prompt、cfg_scale、camera_control、mode=4k はサポートされません。
video_list を使用する場合、generate_audio は false にする必要があります。ベース動画と開始／終了フレームは併用できません。
element_list には、プラットフォームが所有する既存の ID または検証済みのプリセット ID を指定できます。外部の生 ID は拒否されます。単独での管理機能は公開されていません。
モーション制御（/kling/motion）は、動画生成とは別のエンドポイントです。
リップシンクは別のエンドポイント（/kling/lip-sync）で、mode が必要です。audio2video では audio_url を、text2video では text と音声関連フィールドを使用してください。
トーキングフォトは別のエンドポイント（/kling/talking-photo）で、image_url と audio_url の両方が必要です。
選択したモデルと品質モードについて、現在のプラットフォーム料金を確認してください。料金比率は異なります。Turbo の標準／pro 料金は、実際に生成された 1 秒あたり 1.12／1.4 Credits です。
タスクの状態には "succeeded" ではなく "succeed" が使われます。ポーリング時はこの値を確認してください。
negative_prompt を使うと、不要な要素（例：「ぼやけている、低品質、テキスト」）を避けられます。

Turbo、マルチショット、コマース

Turbo はテキストまたは最初のフレームを受け付けます。generate_audio は省略するか、true に設定してください。false はサポートされません。末尾フレーム、camera_control、cfg_scale、個別の negative_prompt、Omni リファレンスは使用できません。コンパニオン MCP では kling_generate_turbo_video を、CLI では kling turbo --request-file request.json を使用してください。

V3/V3 Omni は multi_shot=true に対応しています。自動の shot_type="intelligence" ではグローバルプロンプトを使用します。ショットをカスタマイズする場合は multi_prompt を使用します（エントリーは 1～6 個、連続したインデックス値、最大 512 文字のプロンプト、合計時間と一致する整数の長さが必要です）。コンパニオンツール：kling_generate_storyboard / kling storyboard。

商用機能には /kling/goods-studio と /kling/video-commerce を使用します。構造化された内容／設定を渡し、タスク ID を /kling/tasks でポーリングしてください。アパレル、バーチャル試着、単独でのアセット管理は現在公開されていません。

リファレンス入力

element_list と voice_list は、有効なプラットフォームリファレンスと、現在のバックエンドガイドでサポートされているモデルの組み合わせでのみ使用してください。単独でのアセット作成および管理機能は公開されていません。

Markdown 対応

ログインしてコメント

基本情報

作者: acedatacloud
リポジトリ: acedatacloud/skills
カテゴリ: クリエイティブ・メディア
インストール数: 232
GitHub スター: 17

問題を報告

モード	参照動画なし	課金対象の参照動画が5秒の場合
std	4.005 Credits	6.010 Credits
pro	5.340 Credits	8.010 Credits