ClipmivoAI

ClipmivoAI 開発者ツール

ClipmivoAI API、CLI、ローカル MCP サーバー、またはエージェントスキルを使って AI 動画を作成できます。すべてのクライアントは **https://clipmivoai.com/api/v1**、スコープが設定された API キー、および ClipmivoAI アカウントの残高を使用します。

英語 · 簡体字中国語 · ウェブサイト · API ガイド · OpenAPI

インターフェースを選択

インターフェース	まずはこちら
REST API	認証、見積もり、タスクの送信
CLI	CLI のインストールと使用
MCP	ローカルの stdio サーバーへの接続
エージェントスキル	clipmivo-video

ClipmivoAI にサインインし、API / CLI（Developer）ワークスペースでスコープが設定されたキーを作成して、ウェブサイトからクレジットを追加してください。読み取り操作には video:read、見積もりと生成には video:write、メディアのアップロードには files:write が必要です。API リクエストで作成されるのは動画タスクであり、クレジットの追加購入ではありません。

インストール

Node.js 22+ と npm が必要です。公開ダウンロードは GitHub Releases でホストされているため、以下のコマンドは npm レジストリへの登録に依存しません。

npm install -g https://github.com/BarneyD66/clipmivo-tools/releases/download/v0.1.1/clipmivo-cli-0.2.7.tgz
npm install -g https://github.com/BarneyD66/clipmivo-tools/releases/download/v0.1.1/clipmivo-mcp-0.1.8.tgz
clipmivo --version
clipmivo-mcp --version

シェルまたはシークレットマネージャーを使用して CLIPMIVO_API_KEY を設定してください。実際のキーをこのリポジトリに記載しないでください。開発時は次のようにします。

git clone https://github.com/BarneyD66/clipmivo-tools.git
cd clipmivo-tools
npm ci
npm test
node cli/bin/clipmivo.mjs models --json

最初の動画

clipmivo models --json
clipmivo balance --json
clipmivo quote --file examples/request.json --json

現在の見積もりを確認し、支出上限を確認してください。CLI の見積もり確認例に従って、別のリクエストファイルに quoted_credits を追加してから送信します。

clipmivo generate --file quoted-request.json --idempotency-key my-first-shot-001 --wait --timeout 600 --json
clipmivo get TASK_ID --json
clipmivo download TASK_ID --output result.mp4 --json

送信結果が不確かな場合は、同じ確認済みリクエストと冪等性キーを引き続き使用してください。待機タイムアウトは動画生成の失敗を意味しません。別のタスクを作成するのではなく、ステータスの問い合わせを再開してください。モデルのオプションや価格は変更される場合があります。最新のモデル情報と見積もりを使用してください。

クレジット請求とアプリケーション

credits_to_hold はそのままクレジットとして表示してください。API のクレジット見積もりに 100 を掛けてはいけません。生成前にクレジットが確保され、該当する場合は実際の使用量に基づいて精算されます。未使用の確保済みクレジットは残高に戻されます。換算基準は 100 クレジット = US$1 です。クレジットの追加購入はウェブサイトで別途行います。

顧客向けアプリでは、ClipmivoAI のキーをサーバー上で管理してください。同じアカウントのキーは残高とアカウントレベルのリソースを共有します。再販業者向けの分離されたサブアカウントではありません。アプリケーション連携を参照してください。

MCP

ローカル stdio MCP に対応したクライアントを設定してください。

{
  "mcpServers": {
    "clipmivo": {
      "command": "clipmivo-mcp",
      "env": {
        "CLIPMIVO_API_KEY": "YOUR_SCOPED_API_KEY",
        "CLIPMIVO_FILES_DIR": "/absolute/path/to/video-files"
      }
    }
  }
}

実際のキーはクライアントのシークレット設定に保存してください。Windows では C:/Users/you/Videos/Clipmivo など、既存のディレクトリを使用してください。クライアントがコマンドのシムを解決できない場合は、MCP ガイドを参照してください。これはローカルサーバーであり、ホスト型の MCP OAuth エンドポイントではありません。

スキル

skills/clipmivo-video を、エージェントがサポートするスキルディレクトリにコピーしてください。Codex の場合は ~/.codex/skills/clipmivo-video を使用します。スキルを再起動または再読み込みしてから、次のように依頼します。

$clipmivo-video を使って、池に浮かぶ紙のボートの動画を作成してください。生成に使える上限額は 25 クレジットです。

スキルはインストール済みの MCP または CLI を使用できます。既存の予算承認を維持し、有料の送信前に有効な見積もりを要求します。スキルをインストールしても API キーは作成されず、クレジットも付与されません。

サポート

認証情報や非公開メディアを含めず、再現可能なクライアントのバグについては GitHub の issue を使用してください。アカウント、支払い、請求に関するお問い合わせ先：[email protected]。本サービスの利用には、引き続きウェブサイトの利用規約とプライバシーポリシーが適用されます。

このリポジトリには公開クライアントツールとドキュメントが含まれており、ウェブサイトのバックエンドは含まれていません。