Deux façons de s'en servir
ClipOnIt の2つのプロダクトを、コードからまたはエージェント経由で呼び出せます。
AI Explainer
研修ツール:レッスンごとに解説動画を1本
お使いのプロダクトがレッスンのタイトルor本文を送信すると、ClipOnItがシーンを書き、イラストを付け、ナレーションと字幕を入れて、縦型のMP4を生成します。それをコースの横に表示できます。
POST /api/agent/produceMCP
ClipOnItを操作するAIエージェント
エージェント(Claude、Cursor、VS Code、または自作のもの)は MCP サーバーに接続し、動画の取り込み、クリップの選択、解説動画の生成、結果の待機を、説明済みのツールを使って行います。
POST /mcp
常に同じフロー
動画の生成には数ミリ秒ではなく数分かかります。タスクを作成し、その状態を確認して、ファイルを取得してください。
- タスクを作成
テーマまたは動画のリンクを含むPOSTリクエスト。すぐにIDが返されます。
- 状態を確認
約10秒ごとにGETリクエストを送信し、ステップ、進捗率、残り時間を確認してください。Explainerでは、代わりにWebhookで通知を受け取ることもできます。
- 動画を取得
完了すると、レスポンスにMP4のURLが含まれます。ダウンロードするか、ご自身のプロダクト内で表示してください。
AI Explainer
テーマから解説動画を作成
POST /api/agent/produce はテーマ(または台本、または音声録音)を受け取り、執筆とレンダリングを開始します。GET /api/jobs/{id} は、動画の準備ができると status、step、percent、そして url を返します。
- duration_s15~180秒
- スタイル24 種類のビジュアルスタイルに加え、独自のスタイルも:GET /api/explainer/styles
- voiceカタログ内の音声を、名前またはIDで指定
- dry_runtrue:クォータと料金を確認するだけで、何も実行しません
curl -s -X POST https://cliponit.app/api/agent/produce \
-H "Authorization: Bearer $CLIPONIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"topic": "La photosynthèse en 3 étapes", "duration_s": 45}'
curl -s https://cliponit.app/api/jobs/JOB_ID \
-H "Authorization: Bearer $CLIPONIT_API_KEY"
curl -s -o lecon.mp4 "URL_DU_JOB"const API = "https://cliponit.app";
const headers = {
Authorization: `Bearer ${process.env.CLIPONIT_API_KEY}`,
"Content-Type": "application/json",
};
async function call(method, path, body) {
const res = await fetch(API + path, { method, headers, body: body && JSON.stringify(body) });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
return res.json();
}
let { job } = await call("POST", "/api/agent/produce", { topic: "La photosynthèse en 3 étapes", duration_s: 45 });
while (!["done", "failed", "canceled"].includes(job.status)) {
await new Promise((r) => setTimeout(r, 10_000));
job = await call("GET", `/api/jobs/${job.id}`);
}
console.log(job.status === "done" ? job.url : job.error);import json, os, time, urllib.request
API = "https://cliponit.app"
KEY = os.environ["CLIPONIT_API_KEY"]
def call(method, path, body=None):
req = urllib.request.Request(API + path, method=method,
data=None if body is None else json.dumps(body).encode(),
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"})
with urllib.request.urlopen(req) as r:
return json.load(r)
job = call("POST", "/api/agent/produce", {"topic": "La photosynthèse en 3 étapes", "duration_s": 45})["job"]
while job["status"] not in ("done", "failed", "canceled"):
time.sleep(10)
job = call("GET", f"/api/jobs/{job['id']}")
if job["status"] == "done":
urllib.request.urlretrieve(job["url"], "lecon.mp4")
else:
print(job["error"])MCP
エージェント向けの MCP サーバー
単一のアドレス https://cliponit.app/mcp、HTTP「streamable」方式。ツールは2つのプロダクトすべてをカバーします:取り込み、待機、クリップの作成と書き出し、解説動画の生成と完了待ち。内容を変更するツールには注釈が付いており、エージェントが実行前に確認を求めます。
Claude DesktopとClaude.ai:設定 → コネクタ → カスタムコネクタを追加を選び、上記のアドレスを入力します。接続はOAuthで行うため、コピーするキーはありません。ChatGPTも同じ方法で使えます。ステップごとの手順
claude mcp add --transport http cliponit https://cliponit.app/mcp \
--header "Authorization: Bearer $CLIPONIT_API_KEY"{
"mcpServers": {
"cliponit": {
"url": "https://cliponit.app/mcp",
"headers": { "Authorization": "Bearer ${env:CLIPONIT_API_KEY}" }
}
}
}{
"inputs": [
{ "type": "promptString", "id": "cliponit-key", "description": "ClipOnIt API key", "password": true }
],
"servers": {
"cliponit": {
"type": "http",
"url": "https://cliponit.app/mcp",
"headers": { "Authorization": "Bearer ${input:cliponit-key}" }
}
}
}curl -s -X POST https://cliponit.app/mcp \
-H "Authorization: Bearer $CLIPONIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_quota", "arguments": {}}}'確認の代わりに通知を受け取る
「設定」→「連携」で、https の URL を最大 3 件追加します。Explainer の制作が完了すると、ClipOnIt は job.done または job.failed を送信します。内容は GET /api/jobs/{id} と同じオブジェクトです。失敗時は6回再試行され、およそ 8 時間にわたります。
Smart Clipper のクリップについては、まだ Webhook はありません。GET で状態を確認してください。
import hashlib, hmac, time
def verify(secret: str, header: str, body: bytes, tolerance: int = 300) -> bool:
"""header = X-ClipOnIt-Signature, body = raw request bytes."""
parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
if abs(time.time() - int(parts.get("t", 0))) > tolerance:
return False
mac = hmac.new(secret.encode(), parts["t"].encode() + b"." + body, hashlib.sha256).hexdigest()
return hmac.compare_digest(mac, parts.get("v1", ""))プランごとの上限とクォータ
API の呼び出しも画面上の操作と同じ扱いです。同じクォータ、同じアカウントを使います。料金を見る
| 無料 | Starter | Pro | Business | |
|---|---|---|---|---|
| API と MCP | — | ✓ | ✓ | ✓ |
| 月あたりのExplainer動画数 | — | 15 | 30 | 100 |
| 同時に実行できるExplainerの制作数 | — | 2 | 2 | 2 |
| アカウントごとの API キー | — | 10 | 10 | 10 |
| アカウントごとの Webhook | — | 3 | 3 | 3 |
- APIキーはサーバー側に保管してください。キーはClipOnItアカウント全体へのアクセス権を持ちます。ブラウザ、モバイルアプリ、Gitリポジトリには絶対に置かないでください。環境変数に保存し、バックエンドからClipOnItを呼び出してください。
- 用途ごとにキーを発行し、権限範囲を設定。権限は「読み取り」(閲覧・確認)または「制作」(動画の作成)から選択。各キーには名前と最終使用日があり、ワンクリックで失効できます。失効すると、次の呼び出しから 401 を返します。
- シークレットは一度だけ表示されます。ClipOnIt には、そのフィンガープリント(SHA-256)のみを保存します。紛失した場合はキーを再発行するしかなく、再表示はできません。
- 署名付きWebhook。各送信にはX-ClipOnIt-Signature(本文とタイムスタンプのHMAC-SHA256)が含まれます。5分を超える送信は拒否してください。受信URLはhttpsで、送信のたびに検証されます。
- EU 域内でホスティング。サーバーは EU 内の Hetzner。サブプロセッサーはプライバシーポリシーに記載。
よくある質問
SDK、ウィジェット、所要時間、クォータ、利用量。
API にはどのプランが必要ですか?
Le plan gratuit suffit pour commencer : la clé se crée et le serveur MCP répond, pour 3 vidéos Explainer par mois avec filigrane, dans les 8 styles gratuits. Les plans payants ajoutent plus de vidéos (15, 30 ou 100 par mois), sans filigrane, les 24 styles, ta voix au micro et le Réalisateur IA. Les quotas de l'API sont ceux du compte, comme dans l'interface.
SDKはありますか?
現時点で公式SDKはありません。APIはHTTPとJSONで提供され、OpenAPI 3.1(/openapi.json)で記述されています。このページの例は、fetchや標準のPythonで数行に収まります。OpenAPIファイルからクライアントを生成することもできます。
自分のサイトに ClipOnIt のプレーヤーやエディターを埋め込めますか?
埋め込み可能なウィジェットはありません。MP4 ファイルを取得して、お使いのプレーヤーで表示するか、自分のサーバーでホストしてください。
動画の作成にはどのくらい時間がかかりますか?
解説動画:数分かかります(執筆の後にレンダリング。レンダリングはおよそ 4 分)。クリップ:20 分の動画で、およそ 1〜5 分。その後、各クリップを書き出します。API は、ステップ、進捗率、残り時間の目安を返します。
上限に達するとどうなりますか?
APIは、わかりやすいメッセージとともに402を返します(月間の上限またはAI予算)。機能がプランに含まれていない場合は403、Explainerの制作がすでに2件進行中の場合は429を返します。Explainerでは、「dry_run」: true を指定すると、何も作成・請求せずに、実行前にすべてを検証できます。
すべてのユーザー向けに ClipOnIt を連携させたい場合
Une clé agit sur un seul compte ClipOnIt : les vidéos et les quotas sont ceux de ce compte. Pour un usage à plus grande échelle, écris-nous à contact@cliponit.app avec ton volume et ton cas d'usage.
今日、API で最初の動画を作成しよう
Crée une clé, copie un exemple, lance-le. Une question sur ton intégration : contact@cliponit.app.