面向开发者和 SaaS
用几次调用,把 AI 视频加入你的产品
一个 REST API、一台 MCP 服务器和 Webhooks:你的产品可以生成讲解视频,并把长视频切成 Shorts,用户无需打开 ClipOnIt。
需要 Starter 或更高套餐 · 密钥可在“设置 → 集成”中创建
两种使用方式
ClipOnIt 的两款产品,可从你的代码或智能体调用。
AI Explainer
培训工具:每节课一个讲解视频
你的产品发送课程标题或课程文本;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目录中的声音,可按名称或标识符查找
- 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
一台面向 AI 智能体的 MCP 服务器
唯一地址 https://cliponit.app/mcp,采用「streamable」HTTP。工具覆盖两款产品:导入、等待、创建和导出片段,生成讲解视频并等待其完成。会修改内容的工具已做标注,便于智能体先征求确认。
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)。密钥丢失后只能替换,无法找回。
- 已签名的 webhook。每次发送都带有 X-ClipOnIt-Signature(基于正文和时间戳的 HMAC-SHA256);拒绝任何超过 5 分钟的发送。接收 URL 必须为 https,且每次发送时都会验证。
- 托管在欧盟。服务器为欧盟的 Hetzner;分包商列在隐私政策中。
常见问题
SDK、小组件、延迟、配额和用量。
API 需要哪个套餐?
需要 Starter 或更高套餐。免费套餐没有 API 和 MCP 访问权限:无法创建密钥,MCP 服务器会返回“套餐无 API 访问权限”。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.