適用於開發者與 SaaS

只需幾個呼叫,就能把 AI 影片加進你的產品

一個 REST API、一個 MCP 伺服器與 webhooks:你的產品可以製作解說影片,並將長影片剪成短影片,使用者無需開啟 ClipOnIt。

免費方案即可使用(每月 3 支帶浮水印的影片)· 金鑰可在「設定 → 整合」中建立

兩種使用方式

ClipOnIt 的兩項產品,可從你的程式碼或 AI 代理呼叫。

  • AI Explainer

    培訓工具:每堂課一段解說影片

    你的產品傳送課程標題或內容;ClipOnIt 撰寫場景、為其配圖、加入配音與字幕,然後轉譯出直式 MP4,讓你顯示在課程旁邊。

    POST /api/agent/produce

  • MCP

    一個能操作 ClipOnIt 的 AI 代理

    你的 AI 代理(Claude、Cursor、VS Code 或你自己的)可連上 MCP 伺服器:它能匯入影片、挑選片段、啟動解說影片,並透過已說明好的工具等待結果。

    POST /mcp

始終相同的流程

影片製作需要幾分鐘,而非幾毫秒:建立任務、追蹤狀態,然後取得檔案。

  1. 建立任務

    發送一個 POST,附上影片的主題或連結。立即回應並提供一組識別碼。

  2. 追蹤狀態

    約每 10 秒送出一次 GET:包含步驟、進度百分比與剩餘時間。若使用 Explainer,可改用 webhook 通知你。

  3. 取得影片

    完成後,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"

MCP

供代理使用的 MCP 伺服器

唯一網址 https://cliponit.app/mcp,採用 HTTP「streamable」。工具涵蓋兩項產品:匯入、等待、建立與匯出片段,製作解說影片並等待完成。會修改內容的工具都有標註,讓代理先詢問再執行。

Claude Desktop 與 Claude.ai:設定 → 連接器 → 新增自訂連接器,填入上方的網址。透過 OAuth 登入,無需複製金鑰;ChatGPT 的運作方式相同。逐步說明

使用 Claude 生成影片:工具、範例、配額

claude mcp add --transport http cliponit https://cliponit.app/mcp \
  --header "Authorization: Bearer $CLIPONIT_API_KEY"

主動通知,不必再詢問

在「設定 → 整合」中,最多新增 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 呼叫的計算方式與介面相同:同樣的配額,同一個帳號。查看價格

免費StarterProBusiness
API 與 MCP—✓✓✓
每月 Explainer 影片—1530100
同時進行的 Explainer 製作—222
每個帳戶的 API 金鑰—101010
每個帳戶的 Webhooks—333

安全性

從你的伺服器呼叫 ClipOnIt,切勿從使用者的瀏覽器呼叫。

隱私權政策
  • 金鑰只留在你的伺服器上。它能存取整個 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.

llms-api.txt · OpenAPI 3.1 · mcp.json