適用於開發者與 SaaS
只需幾個呼叫,就能把 AI 影片加進你的產品
一個 REST API、一個 MCP 伺服器與 webhooks:你的產品可以製作解說影片,並將長影片剪成短影片,使用者無需開啟 ClipOnIt。
免費方案即可使用(每月 3 支帶浮水印的影片)· 金鑰可在「設定 → 整合」中建立
兩種使用方式
ClipOnIt 的兩項產品,可從你的程式碼或 AI 代理呼叫。
AI Explainer
培訓工具:每堂課一段解說影片
你的產品傳送課程標題或內容;ClipOnIt 撰寫場景、為其配圖、加入配音與字幕,然後轉譯出直式 MP4,讓你顯示在課程旁邊。
POST /api/agent/produceMCP
一個能操作 ClipOnIt 的 AI 代理
你的 AI 代理(Claude、Cursor、VS Code 或你自己的)可連上 MCP 伺服器:它能匯入影片、挑選片段、啟動解說影片,並透過已說明好的工具等待結果。
POST /mcp
始終相同的流程
影片製作需要幾分鐘,而非幾毫秒:建立任務、追蹤狀態,然後取得檔案。
- 建立任務
發送一個 POST,附上影片的主題或連結。立即回應並提供一組識別碼。
- 追蹤狀態
約每 10 秒送出一次 GET:包含步驟、進度百分比與剩餘時間。若使用 Explainer,可改用 webhook 通知你。
- 取得影片
完成後,MP4 的網址會包含在回應中。下載它,或在你的產品中顯示。
AI Explainer
從一個主題生成解說影片
POST /api/agent/produce 接收主題(或腳本,或語音錄製),並開始撰寫,接著進行渲染。GET /api/jobs/{id} 會依序回傳 status、step、percent,影片完成後再回傳 url。
- duration_s15 至 180 秒
- 風格24 種視覺風格,外加你自己的:GET /api/explainer/styles
- voice目錄中的語音,可依名稱或識別碼指定
- 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」。工具涵蓋兩項產品:匯入、等待、建立與匯出片段,製作解說影片並等待完成。會修改內容的工具都有標註,讓代理先詢問再執行。
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": {}}}'主動通知,不必再詢問
在「設定 → 整合」中,最多新增 3 個 https 網址。Explainer 製作完成時,ClipOnIt 會把 job.done 或 job.failed 傳送到這些網址,內容與 GET /api/jobs/{id} 的物件相同。失敗時最多重試六次,大約在 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 |
| 每個帳戶的 Webhooks | — | 3 | 3 | 3 |
- 金鑰只留在你的伺服器上。它能存取整個 ClipOnIt 帳號:絕不要放在瀏覽器、行動應用程式或 Git 儲存庫中。請把它存在環境變數裡,並從你的後端呼叫 ClipOnIt。
- 每個用途一把金鑰,並限定範圍。範圍可選「讀取」(查看、驗證)或「製作」(建立影片)。每把金鑰都有名稱與最後使用日期,點一下即可撤銷;撤銷後,下一次呼叫即會回應 401。
- 密鑰只會顯示一次。ClipOnIt 只保存其指紋(SHA-256)。金鑰遺失後只能重新產生,無法再次查看。
- 已簽署的 Webhooks。每次傳送都帶有 X-ClipOnIt-Signature(依內容與時間戳計算的 HMAC-SHA256);拒絕任何超過 5 分鐘的傳送。接收 URL 須使用 https,且每次傳送都會驗證。
- 託管於歐盟。伺服器位於歐盟的 Hetzner;分包商列於隱私權政策中。
常見問題
SDK、小工具、延遲、配額與用量。
API 需要哪個方案?
免費方案即可開始:建立金鑰、MCP 伺服器即可回應,每月可製作 3 支附浮水印的 Explainer 影片,使用 8 種免費風格。付費方案提供更多影片(每月 15、30 或 100 支),無浮水印,並開放全部 24 種風格、你的語音錄製與 AI 導演。API 配額與帳戶相同,與介面一致。
有 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 製作正在進行,回傳 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.