Kaloclip AI 動画作成 (clip)
Kaloclip は、商品情報と画像をショート動画のスクリプトに変換し、スクリプトを完成した動画に仕上げます。アカウントは API キーを所有するアカウントであり、そのクレジット、Kaloclip メンバーシップ（動画キューのサイズ、Free プランのウォーターマーク）、画像アセット、ジョブが紐づきます。ほとんどのコマンドは無料です。[credits] のコマンドは有料のジョブを送信します。使用する前に「クレジットの消費」を確認してください。
実行
CLI はこのスキル内に同梱されています（scripts/clip.py、Python 3.11+、標準ライブラリのみ — インストール不要）:
python3 <this-skill-dir>/scripts/clip.py オプション
以下の例では、clip を python3 <this-skill-dir>/scripts/clip.py の省略形として使用します。
出力は標準出力に TOON（トークン指向）形式で出力されます。任意のコマンドに --json を追加すると、生の JSON が出力されます。エラーは標準出力に構造化され、アクション可能な help: 行が含まれます。終了コード: 0 正常、1 エラー、2 使用方法の誤り。
セットアップ — 最初の呼び出し前に確認
すべてのコマンドには KaloData OpenAPI キー（secret-key ヘッダーとして送信）が必要です。これは kalodata スキルの kalo CLI が使用するものと同じキーであり、同じ場所に保存されます。セッションの最初の呼び出しの前に clip config を実行し、api_key を確認してください。missing と表示されたら、停止してください — キーを推測したり、再試行したりしないでください。ユーザーに以下の手順を案内し、待機してください:
-
キーを取得 — https://www.kalodata.com/open-center/account にサインインし、generate key をクリックしてください。アカウントがない場合、まず https://www.kalodata.com/open-center/home で登録してください。
-
保存 —
clip config set --key <API_KEY>（~/.config/kalodata/config.tomlに保存、モード 0600、kaloと共有）、または環境変数KALODATA_API_KEYを設定します。 -
クレジット — KaloData と同じクレジット残高です。Kaloclip の料金とメンバーシップルールが適用されます。
clip creditで残高を確認できます。コマンド クレジット options、credit、product resolve、image upload/import、video preview、get/job無料 script create2 video createvideo previewがモデル/時間/解像度に応じて表示する値（例: sd2 · 15s · 720P = 28）analysis createスクリプト分析に対する Kaloclip の料金
コマンド
| コマンド | 説明 |
|---|---|
clip options | 現在利用可能なモデル、時間、解像度。どのモデルがどの時間に対応しているか。 |
clip credit | 残りクレジット |
clip product resolve <リンク> | 商品リンク → タイトル、カテゴリ、セールスポイント、画像アセット |
clip image upload <ファイル...> | 1～6 枚のローカル画像（JPEG/PNG/GIF/WebP、5MB 以下）→ アセット ID |
clip image import <URL...> | 1～6 つの公開 https 画像 URL → アセット ID |
clip script create | [credits] スクリプトの下書き。--product-link、または --image --title --category |
clip script get <job_id> | 下書きの状態とスクリプトテキスト。--wait オプションあり |
clip script candidates <job_id> | Kaloclip ウェブサイトで作成されたリライトジョブの 2 つの候補 |
clip video preview | 動画にかかるクレジット。--model --duration --resolution --ratio |
clip video create | [credits] 完成したスクリプト → 動画。--script-job / --script-file / --script |
clip video get <job_id> | 動画の状態。完了すると videoUrl が含まれる。--wait オプションあり |
clip analysis create <動画URL> | [credits] 既存の動画のショットごとの分析。--commerce --country |
clip analysis get <job_id> | 分析の状態と結果（30 日間保持）。--wait オプションあり |
clip job <job_id> | 任意のジョブの状態と出力。--wait オプションあり |
clip config | キーの表示/設定（kalo と共有）とエンドポイント（--base-url staging） |
動画作成フロー
clip options— その出力から--modelと--durationを一緒に選択します。モデルとその時間は変更されるため、記憶からモデルを使用しないでください。- 商品素材:
clip product resolve <リンク>でリンクから得られる内容を確認し、同じ--product-linkをscript createに渡します。または- ユーザー自身の画像:
clip image upload a.png b.jpg→--image ASSET_ID=IMAGE_URL（繰り返し、1～6 個）、さらに--titleと--category。
- 動画の雰囲気（トーン、シーン、フック）をユーザーに尋ね、
--descriptionとして渡します。 clip script create --product-link <リンク> --model <M> --duration <S> --description "..."→ ドライラン。結果を表示し、承諾を得たら、--yes --idempotency-key <ヒントのキー> --waitで再実行します（下書きには約 30～60 秒かかります。クレジットは送信時に課金されます）。- スクリプトを表示します。変更するには、編集したテキストをファイルに書き込み、
--script-fileを使用します。 clip video create --script-job <job_id> [--script-file edited.txt] [--resolution 1080P]→ クレジットコストを含むドライラン。承諾を得たら、--yes --idempotency-key <キー>で再実行します。clip video get <job_id> --wait— 15 秒の動画は約 15 分かかります（--waitは最大 20 回ポーリング）。ユーザーに実行中であることを伝え、--waitがタイムアウトした場合は再度ポーリングしてください。決して再送信しないでください。videoUrl（mp4）とcoverImageUrlをユーザーに渡します。
--script-job は、このマシンで下書きが作成されたときに使用された画像、タイトル、モデル、時間を再利用します。それ以外の場合は、再度渡す必要があります（--product-link でほとんどカバーできます）。
クレジットの消費
[credits] のコマンドは、最初の実行では何も実行しません。--yes がない場合、正確なリクエスト（dry_run:）、そのクレジットコスト、冪等性キーを出力し、何も送信しません。ユーザーに表示し、明示的な承諾を得てから、--yes --idempotency-key <キー> で再実行してください。自分で --yes を追加したり、ループ送信したりしないでください。
- 再試行: 送信が「結果不明」（タイムアウト / 5xx / SUBMISSION_IN_PROGRESS）で終了した場合、同じ
--idempotency-keyを使用して同一のコマンドを 5 分以内に再実行してください。Kaloclip は元のジョブを返し、再度課金されません。新しいキーは新しい有料ジョブを意味します。SUBMISSION_OUTCOME_UNKNOWN: 停止してユーザーに伝えてください。再送信しないでください。 - ジョブは非同期: ジョブ ID を保持し、
--waitでポーリングします（5 秒ごと）。queuedまたはprocessing状態のジョブを再送信しないでください。 TASK_QUEUE_FULL: メンバーシップのビデオキューがいっぱいです（Free プランでは一度に 1 動画）。課金は行われません。実行中の動画が終了するのを待ってから、再度送信してください。RATE_LIMIT_EXCEEDED: ユーザーごとの制限（アップロード/インポート 10/分、商品解決 10/分、プレビュー 20/分、動画 5/分）— 少なくとも 60 秒待機してください。
スクリプト分析
clip analysis create <tiktok|kalodata|youtube-shorts url> は、動画をシーン（video_scripts[]: 時間、ショットスケール、視覚的説明、ナレーション、それぞれに翻訳あり）に分解し、プレゼンターの性別、話し言葉、カメラワーク、効果の理由を出力します。ショッパブルな TikTok 動画の場合: --commerce --country US を追加します。結果は 30 日間読み取り可能です（clip analysis get <job_id>）。すべてのフィールドを取得するには --json を追加します。バイラル動画から学習し、独自のスクリプトを作成する前に活用してください。
データの正しい読み方
- 完成した下書きのスクリプトは、長文の指示（タレント、スタイル、シーン、シーンごとの VISUAL / AUDIO / TALENT ACTION）です。全体を表示し、ユーザーが承認する前に要約しないでください。
video previewは見積もりです。送信が拒否される場合があります（キュー、メンバーシップ、入力）。videoUrlは完成したファイルです。Free メンバーシップの動画にはウォーターマークが付きます。product resolveのselling_pointsは、Kaloclip が商品を分析中の場合、空になることがあります。1 分後に再実行するか、なしで続行してください。- 画像アセットはアカウントに属します。あるキーのアセット ID は別のキーでは機能しません。