डेवलपर्स और SaaS के लिए
कुछ ही कॉल में अपने प्रोडक्ट में AI वीडियो जोड़ो
एक REST API, एक MCP सर्वर और webhooks: तुम्हारा प्रोडक्ट explainer वीडियो बनाता है और लंबे वीडियो को शॉर्ट्स में काटता है, बिना तुम्हारे उपयोगकर्ताओं के ClipOnIt खोले।
मुफ़्त प्लान से (3 वीडियो प्रति माह, वॉटरमार्क के साथ) · API कुंजी Réglages → Intégrations में बनाई जाती है
इसे इस्तेमाल करने के दो तरीके
ClipOnIt के दोनों प्रोडक्ट, जिन्हें तुम्हारे कोड से या एजेंट द्वारा कॉल किया जा सकता है।
AI Explainer
एक प्रशिक्षण टूल: हर पाठ के लिए एक व्याख्यात्मक वीडियो
तुम्हारा प्रोडक्ट पाठ का शीर्षक या टेक्स्ट भेजता है; ClipOnIt दृश्य लिखता है, उन्हें चित्रित करता है, आवाज़ और सबटाइटल जोड़ता है, फिर एक वर्टिकल MP4 रेंडर करता है जिसे तुम पाठ्यक्रम के साथ दिखाते हो।
POST /api/agent/produceMCP
ClipOnIt को चलाने वाला एक AI एजेंट
तुम्हारा एजेंट (Claude, Cursor, VS Code या तुम्हारा अपना) MCP सर्वर से जुड़ता है: वह एक वीडियो आयात करता है, क्लिप चुनता है, एक explainer वीडियो लॉन्च करता है और पहले से वर्णित टूल्स के साथ नतीजे का इंतज़ार करता है।
POST /mcp
हमेशा वही प्रवाह
एक वीडियो में मिनट लगते हैं, मिलीसेकंड नहीं: तुम एक कार्य बनाते हो, उसकी स्थिति देखते हो, और फ़ाइल प्राप्त करते हो।
- कार्य बनाएँ
विषय या वीडियो के लिंक के साथ एक POST। तुरंत एक पहचानकर्ता के साथ जवाब मिलता है।
- स्थिति देखें
हर लगभग 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
एजेंट्स के लिए एक MCP सर्वर
एक ही पता https://cliponit.app/mcp, “streamable” HTTP पर। टूल दोनों प्रोडक्ट कवर करते हैं: क्लिप इम्पोर्ट करना, उनके प्रोसेस होने का इंतज़ार, बनाना और एक्सपोर्ट करना, एक explainer वीडियो बनाना और उसके पूरा होने तक इंतज़ार करना। जो चीज़ें बदलते हैं उन पर नोट है, ताकि एजेंट पहले पूछे।
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 URL जोड़ो। जब कोई 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 कॉल UI की तरह ही गिने जाते हैं: वही कोटा, वही खाता। प्लान देखें
| फ़्री | Starter | Pro | Business | |
|---|---|---|---|---|
| API और MCP | — | ✓ | ✓ | ✓ |
| हर महीने Explainer वीडियो | — | 15 | 30 | 100 |
| एक साथ Explainer प्रोडक्शन | — | 2 | 2 | 2 |
| खाते के अनुसार API कुंजियाँ | — | 10 | 10 | 10 |
| प्रति खाता वेबहुक्स | — | 3 | 3 | 3 |
- कुंजी तुम्हारे सर्वर पर ही रहती है।इससे पूरे ClipOnIt खाते तक पहुँच मिलती है: इसे कभी ब्राउज़र, मोबाइल ऐप या Git रिपॉज़िटरी में न रखो। इसे एनवायरनमेंट वेरिएबल में रखो और अपने backend से ClipOnIt को कॉल करो।
- हर उपयोग के लिए एक कुंजी, उसकी पहुँच के साथ।पहुँच "पढ़ना" (देखना, जाँचना) या "प्रोडक्शन" (वीडियो बनाना) होती है। हर कुंजी का एक नाम होता है, आखिरी उपयोग की तारीख होती है, और एक क्लिक में रद्द हो जाती है: यह अगली कॉल से ही 401 हो जाती है।
- सीक्रेट केवल एक बार दिखाया जाता है।ClipOnIt केवल उसका फिंगरप्रिंट (SHA-256) रखता है। खो जाए तो कुंजी बदलनी पड़ती है, उसे दोबारा नहीं देखा जा सकता।
- साइन किए गए Webhooks।हर भेजे गए संदेश में X-ClipOnIt-Signature होता है (मुख्य भाग और टाइमस्टैम्प का HMAC-SHA256); 5 मिनट से पुराने किसी भी भेजे गए संदेश को अस्वीकार करता है। रिसीव करने वाले URL https पर होते हैं और हर भेजने पर जाँचे जाते हैं।
- यूरोपीय संघ में होस्ट किया गया।Hetzner सर्वर EU में; उप-प्रोसेसर गोपनीयता नीति में सूचीबद्ध हैं।
अक्सर पूछे जाने वाले सवाल
SDK, विजेट, समय-सीमा, कोटा और वॉल्यूम।
API के लिए कौन सा प्लान चाहिए?
मुफ़्त प्लान शुरू करने के लिए काफ़ी है: कुंजी बनती है और MCP सर्वर जवाब देता है, वॉटरमार्क के साथ प्रति माह 3 Explainer वीडियो, मुफ़्त 8 स्टाइल में। भुगतान वाले प्लान और वीडियो जोड़ते हैं (15, 30 या 100 प्रति माह), बिना वॉटरमार्क, 24 स्टाइल, माइक से आपकी आवाज़ और AI निर्देशक। API की सीमाएँ खाते की होती हैं, जैसे इंटरफ़ेस में।
क्या कोई SDK है?
अभी कोई आधिकारिक SDK नहीं है। API HTTP और JSON पर है, और OpenAPI 3.1 (/openapi.json) में दर्ज है: इस पेज के उदाहरण fetch या मानक Python की कुछ पंक्तियों में चल जाते हैं, और तुम OpenAPI फ़ाइल से client बना सकते हो।
क्या मैं अपनी साइट में ClipOnIt प्लेयर या एडिटर एम्बेड कर सकता हूँ?
नहीं, कोई embeddable विजेट नहीं है। तुम MP4 फ़ाइल लेते हो और उसे अपने खुद के प्लेयर में दिखाते हो, या अपने यहाँ होस्ट करते हो।
वीडियो बनाने में कितना समय लगता है?
एक explainer वीडियो: कुछ मिनट (स्क्रिप्ट लिखना, फिर रेंडर करना; रेंडर में लगभग 4 मिनट)। क्लिप: 20 मिनट के वीडियो के लिए लगभग 1 से 5 मिनट, फिर हर क्लिप का एक्सपोर्ट। API चरण, प्रतिशत और बचे समय का अनुमान लौटाता है।
जब कोटा खत्म हो जाए तो क्या होता है?
API 402 लौटाता है और साफ़ संदेश देता है (महीने का कोटा या AI बजट), 403 यदि फ़ीचर प्लान में नहीं है, 429 यदि पहले से दो Explainer प्रोडक्शन चल रहे हैं। 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.