面向开发者和 SaaS 产品
几行代码,为你的产品加入 AI 视频
REST API、MCP 服务器和 webhook:您的产品可以生成解说视频,并将长视频剪成短视频,而您的用户无需打开 ClipOnIt。
Starter 套餐或更高版本 · 在“设置 → 集成”中创建密钥
Two ways to use it
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} 返回状态、步骤、百分比,视频就绪后返回 url。
- duration_s15 至 180 秒
- style24 种视觉风格,外加您自己的: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": "Photosynthesis in 3 steps", "duration_s": 45}'
curl -s https://cliponit.app/api/jobs/JOB_ID \
-H "Authorization: Bearer $CLIPONIT_API_KEY"
curl -s -o lesson.mp4 "JOB_URL"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: "Photosynthesis in 3 steps", 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": "Photosynthesis in 3 steps", "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"], "lesson.mp4")
else:
print(job["error"])MCP
面向智能体的 MCP 服务器
单一地址 https://cliponit.app/mcp,基于可流式传输的 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 | — | ✓ | ✓ | ✓ |
| 每月解说视频数 | — | 15 | 30 | 100 |
| 同时进行的 Explainer 制作数 | — | 2 | 2 | 2 |
| 每个账户的 API 密钥数 | — | 10 | 10 | 10 |
| 每个账户的 Webhook 数 | — | 3 | 3 | 3 |
- 密钥应保存在您的服务器上。它可访问整个 ClipOnIt 账户:切勿放在浏览器、移动应用或 Git 仓库中。请将其保存在环境变量中,并从您的后端调用 ClipOnIt。
- 每种用途使用一个密钥,并设定其权限范围。“读取”权限(查询、检查)或“生产”权限(生成视频)。每个密钥都有名称和最后使用日期,可一键撤销:撤销后,下一次调用将返回 401。
- 密钥只显示一次。ClipOnIt 只保存其哈希值(SHA-256)。丢失的密钥只能替换,无法找回。
- 已签名的 Webhook。每次投递都带有 X-ClipOnIt-Signature(时间戳和正文的 HMAC-SHA256);拒绝超过 5 分钟的请求。接收网址必须为 https,且每次投递都会检查。
- 托管于欧盟。服务器为欧盟境内的 Hetzner;数据处理方列于隐私政策中。
常见问题
SDK、小组件、耗时、配额和用量。
使用 API 需要哪个套餐?
Starter 或更高套餐。免费套餐无法使用 API 或 MCP:无法创建密钥,MCP 服务器会返回“plan without API access”。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。
A key acts on a single ClipOnIt account: videos and quotas belong to that account. For larger-scale use, write to contact@cliponit.app with your volume and use case.
今天就通过 API 生成你的第一个视频
Create a key, copy an example, run it. A question about your integration: contact@cliponit.app.