面向开发者和 SaaS

用几次调用,把 AI 视频加入你的产品

一个 REST API、一台 MCP 服务器和 Webhooks:你的产品可以生成讲解视频,并把长视频切成 Shorts,用户无需打开 ClipOnIt。

需要 Starter 或更高套餐 · 密钥可在“设置 → 集成”中创建

两种使用方式

ClipOnIt 的两款产品,可从你的代码或智能体调用。

  • AI Explainer

    培训工具:每节课一个讲解视频

    你的产品发送课程标题或课程文本;ClipOnIt 负责撰写场景、配图,添加配音和字幕,然后生成一个竖屏 MP4,你可以将其与课程一起展示。

    POST /api/agent/produce

  • MCP

    驱动 ClipOnIt 的 AI 代理

    你的代理(Claude、Cursor、VS Code 或你自己的)连接到 MCP 服务器后,可以导入视频、选择剪辑、生成解说视频,并通过已有的工具等待结果。

    POST /mcp

流程始终相同

视频制作需要几分钟,而不是几毫秒:你创建任务,跟踪其状态,然后获取文件。

  1. 创建任务

    发送一个包含视频主题或链接的 POST 请求,立即返回一个 ID。

  2. 跟踪状态

    每隔约 10 秒发送一次 GET 请求:步骤、进度百分比、剩余时间。对于 Explainer,你可以改用 webhook 主动接收通知。

  3. 获取视频

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

MCP

一台面向 AI 智能体的 MCP 服务器

唯一地址 https://cliponit.app/mcp,采用「streamable」HTTP。工具覆盖两款产品:导入、等待、创建和导出片段,生成讲解视频并等待其完成。会修改内容的工具已做标注,便于智能体先征求确认。

Claude Desktop 和 Claude.ai:设置 → 连接器 → 添加自定义连接器,填入上面的地址。通过 OAuth 连接,无需复制密钥;ChatGPT 的方式相同。分步指南

Générer des vidéos avec Claude : outils, exemples, quotas

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)。密钥丢失后只能替换,无法找回。
  • 已签名的 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.

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