สำหรับนักพัฒนาและผลิตภัณฑ์ SaaS
เพิ่มวิดีโอ AI ในผลิตภัณฑ์ของคุณได้ในไม่กี่คำสั่ง
REST API เซิร์ฟเวอร์ MCP และ webhooks: ผลิตภัณฑ์ของคุณสร้างวิดีโออธิบายและตัดวิดีโอยาวเป็นคลิปสั้นได้ โดยที่ผู้ใช้ไม่ต้องเปิด ClipOnIt เลย
จากแพ็กเกจฟรี (วิดีโอมีลายน้ำ 3 ต่อเดือน) · สร้างคีย์ในการตั้งค่า → การผสานรวม
สองวิธีในการใช้งาน
สองผลิตภัณฑ์ของ ClipOnIt เรียกใช้จากโค้ดของคุณ หรือโดยเอเจนต์ก็ได้
AI Explainer
เครื่องมือสำหรับการฝึกอบรม: วิดีโออธิบายหนึ่งรายการต่อหนึ่งบทเรียน
ผลิตภัณฑ์ของคุณส่งชื่อหรือข้อความของบทเรียน; ClipOnIt เขียนฉาก วาดภาพประกอบ เพิ่มเสียงและคำบรรยาย แล้วเรนเดอร์ไฟล์ MP4 แนวตั้งให้คุณแสดงคู่กับหลักสูตร
POST /api/agent/produceMCP
AI agent ที่ควบคุม ClipOnIt
เอเจนต์ของคุณ (Claude, Cursor, VS Code หรือของคุณเอง) เชื่อมต่อกับเซิร์ฟเวอร์ MCP: เอเจนต์นำเข้าวิดีโอ เลือกคลิป เริ่มวิดีโออธิบาย และรอผลลัพธ์ด้วยเครื่องมือที่อธิบายไว้แล้ว
POST /mcp
ขั้นตอนเดียวกันเสมอ
วิดีโอใช้เวลาเป็นนาที ไม่ใช่มิลลิวินาที: คุณสร้างงาน ติดตามสถานะ แล้วดึงไฟล์
- สร้างงาน
POST ครั้งเดียวพร้อมหัวข้อหรือลิงก์วิดีโอ ตอบกลับทันทีพร้อม id
- ติดตามสถานะ
ส่ง GET ประมาณทุก 10 วินาที: ขั้นตอน เปอร์เซ็นต์ และเวลาที่เหลือ สำหรับ Explainer คุณใช้ webhook แจ้งเตือนแทนได้
- ดึงวิดีโอ
เมื่อเสร็จ URL ของ MP4 จะอยู่ในการตอบกลับ ดาวน์โหลดหรือแสดงในผลิตภัณฑ์ของคุณได้เลย
AI Explainer
วิดีโออธิบายจากหัวข้อ
POST /api/agent/produce รับหัวข้อ (หรือสคริปต์ หรือบันทึกเสียง) แล้วเริ่มเขียนและเรนเดอร์ GET /api/jobs/{id} ส่งคืนสถานะ ขั้นตอน เปอร์เซ็นต์ และ 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": "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 ผ่าน streamable HTTP เครื่องมือครอบคลุมทั้งสองผลิตภัณฑ์: นำเข้า รอ สร้างและส่งออกคลิป ผลิตวิดีโออธิบายและรอให้เสร็จ เครื่องมือที่เปลี่ยนแปลงข้อมูลจะมีหมายเหตุกำกับไว้ เพื่อให้เอเจนต์ถามก่อน
Claude Desktop และ Claude.ai: Settings → Connectors → Add custom connector พร้อมที่อยู่ด้านบน การลงชื่อเข้าใช้ผ่าน 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": {}}}'รับการแจ้งเตือนแทนการสอบถามซ้ำ
ใน การตั้งค่า → การผสานรวม เพิ่ม URL แบบ https ได้สูงสุด 3 รายการ เมื่อการผลิต Explainer สิ้นสุด ClipOnIt จะส่ง job.done หรือ job.failed ไปยังที่นั่น พร้อมออบเจ็กต์เดียวกับ GET /api/jobs/{id} ลองใหม่หกครั้งเมื่อล้มเหลว ภายในประมาณ 8 ชั่วโมง
ยังไม่มี webhooks สำหรับคลิปของ Smart Clipper: ติดตามสถานะด้วย 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 |
| เว็บฮุกต่อบัญชี | — | 3 | 3 | 3 |
ความปลอดภัย
เรียกใช้ ClipOnIt จากเซิร์ฟเวอร์ของคุณ อย่าเรียกจากเบราว์เซอร์ของผู้ใช้เด็ดขาด
นโยบายความเป็นส่วนตัว- คีย์ต้องอยู่บนเซิร์ฟเวอร์ของคุณเท่านั้นคีย์นี้เข้าถึงบัญชี ClipOnIt ทั้งหมดได้ ห้ามใส่ในเบราว์เซอร์ แอปมือถือ หรือ Git repo เก็บไว้ในตัวแปรสภาพแวดล้อม และเรียก ClipOnIt จากแบ็กเอนด์ของคุณ
- หนึ่งคีย์ต่อการใช้งาน พร้อมขอบเขตการเข้าถึงขอบเขต “Read” (ค้นหา ตรวจสอบ) หรือ “production” (สร้างวิดีโอ) แต่ละคีย์มีชื่อและวันที่ใช้ล่าสุด และเพิกถอนได้ด้วยการคลิกครั้งเดียว คีย์ที่ถูกเพิกถอนจะส่งคืน 401 ตั้งแต่การเรียกครั้งถัดไป
- ความลับจะแสดงเพียงครั้งเดียวClipOnIt เก็บเฉพาะแฮช (SHA-256) คีย์ที่หายไปต้องสร้างใหม่ ไม่สามารถดึงกลับมาได้
- webhook ที่มีลายเซ็นทุกการส่งมาพร้อม X-ClipOnIt-Signature (HMAC-SHA256 ของ timestamp และเนื้อหา) ปฏิเสธทุกอย่างที่เก่ากว่า 5 นาที URL ที่รับต้องเป็น https และตรวจสอบในทุกการส่ง
- โฮสต์ในสหภาพยุโรปเซิร์ฟเวอร์ Hetzner ในสหภาพยุโรป; ผู้ประมวลผลข้อมูลระบุไว้ในนโยบายความเป็นส่วนตัว
คำถามที่พบบ่อย
SDK, วิดเจ็ต, เวลา, โควต้า และปริมาณการใช้งาน
API ต้องใช้แพ็กเกจไหน?
แพ็กเกจฟรีก็เพียงพอสำหรับการเริ่มต้น: สามารถสร้างคีย์ได้ และเซิร์ฟเวอร์ MCP ตอบกลับได้ สำหรับวิดีโอ Explainer ที่มีลายน้ำ 3 รายการต่อเดือน ในสไตล์ฟรี 8 แบบ แพ็กเกจแบบชำระเงินเพิ่มจำนวนวิดีโอ (15, 30 หรือ 100 รายการต่อเดือน) ไม่มีลายน้ำ ใช้ได้ทุกสไตล์ 24 แบบ พร้อมพากย์เสียงของคุณเองและ AI Director โควต้า API คือโควต้าของบัญชี เหมือนกับในแอป
มี SDK หรือไม่?
ยังไม่มี SDK อย่างเป็นทางการ API ใช้ HTTP และ JSON อธิบายไว้ใน OpenAPI 3.1 (/openapi.json) ตัวอย่างในหน้านี้เขียนได้ไม่กี่บรรทัดด้วย fetch หรือ Python มาตรฐาน และคุณสร้างไคลเอนต์จากไฟล์ OpenAPI ได้
สามารถฝังตัวเล่นหรือตัวแก้ไขของ ClipOnIt ในเว็บไซต์ของฉันได้ไหม
ไม่มีวิดเจ็ตสำหรับฝังนะ คุณดึงไฟล์ MP4 แล้วแสดงในเครื่องเล่นของคุณเอง หรือโฮสต์เองก็ได้
วิดีโอใช้เวลานานแค่ไหน?
วิดีโออธิบายหนึ่งชิ้น: ไม่กี่นาที (เขียนแล้วเรนเดอร์ ประมาณ 4 นาทีสำหรับการเรนเดอร์) คลิป: ประมาณ 1 ถึง 5 นาที สำหรับวิดีโอ 20 นาที จากนั้นส่งออกแต่ละคลิป API ส่งคืนขั้นตอน เปอร์เซ็นต์ และประมาณเวลาที่เหลือ
จะเกิดอะไรขึ้นเมื่อถึงโควต้า?
API จะส่งคืน 402 พร้อมข้อความที่ชัดเจน (โควต้ารายเดือนหรืองบ AI), 403 หากฟีเจอร์ไม่อยู่ในแพ็กเกจ, 429 หากมีการผลิต Explainer สองรายการทำงานอยู่แล้ว สำหรับ 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.