面向开发者和 SaaS 产品

几行代码,为你的产品加入 AI 视频

REST API、MCP 服务器和 webhook:您的产品可以生成解说视频,并将长视频剪成短视频,而您的用户无需打开 ClipOnIt。

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

Two ways to use it

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} 返回状态、步骤、百分比,视频就绪后返回 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"

MCP

面向智能体的 MCP 服务器

单一地址 https://cliponit.app/mcp,基于可流式传输的 HTTP。这些工具覆盖两款产品:导入、等待、创建和导出片段,生成解说视频并等待其完成。会改变数据的工具都带有标注,使智能体会先询问。

Claude Desktop 和 Claude.ai:依次点击 设置 → 连接器 → 添加自定义连接器,填入上面的地址。登录通过 OAuth 完成,无需复制密钥;ChatGPT 的方式相同。分步说明

Generate videos with Claude: tools, examples, 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—✓✓✓
每月解说视频数—1530100
同时进行的 Explainer 制作数—222
每个账户的 API 密钥数—101010
每个账户的 Webhook 数—333

安全

请从你的服务器调用 ClipOnIt,切勿从用户的浏览器调用。

隐私政策
  • 密钥应保存在您的服务器上。它可访问整个 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.

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