Kehittäjille ja SaaS-yrityksille
Lisää AI-video tuotteeseesi muutamalla kutsulla
REST-API, MCP-palvelin ja webhookit: tuotteesi luo selitysvideoita ja leikkaa pitkät videot shortseiksi ilman, että käyttäjäsi avaavat ClipOnItia.
Ilmaisella paketilla (3 videota kuukaudessa vesileimalla) · avain luodaan kohdassa Asetukset → Integraatiot
Kaksi tapaa käyttää sitä
ClipOnItin molemmat tuotteet, kutsuttavissa koodistasi tai agentilta.
AI Explainer
Koulutustyökalu: yksi selitysvideo per oppitunti
Tuotteesi lähettää oppitunnin otsikon tai tekstin; ClipOnIt kirjoittaa kohtaukset, kuvittaa ne, lisää äänen ja tekstitykset ja tuottaa pystysuuntaisen MP4:n, jonka näytät kurssin vieressä.
POST /api/agent/produceMCP
Tekoälyagentti, joka ohjaa ClipOnItiä
Agenttisi (Claude, Cursor, VS Code tai oma) yhdistyy MCP-palvelimeen: se tuo videon, valitsee klipit, käynnistää selitysvideon ja odottaa tulosta valmiiden työkalujen avulla.
POST /mcp
Aina sama kulku
Video vie minuutteja, ei millisekunteja: luot tehtävän, seuraat sen tilaa ja noudat tiedoston.
- Luo tehtävä
POST-pyyntö aiheen tai videolinkin kanssa. Vastaus heti tunnisteella.
- Seuraa tilaa
GET-pyyntö noin 10 s välein: vaihe, prosentti ja jäljellä oleva aika. Explainerin kohdalla webhook voi ilmoittaa sinulle sen sijaan.
- Hae video
Kun valmis, MP4:n URL on vastauksessa. Lataa se tai näytä se omassa tuotteessasi.
AI Explainer
Selitysvideo aiheesta
POST /api/agent/produce vastaanottaa aiheen (tai käsikirjoituksen tai äänitteen) ja käynnistää kirjoituksen ja renderöinnin. GET /api/jobs/{id} palauttaa status, step, percent ja valmiina olevan videon url.
- duration_s15–180 sekuntia
- tyyli24 visuaalista tyyliä ja sinun omasi: GET /api/explainer/styles
- voicekirjaston ääni, nimen tai tunnisteen perusteella
- dry_runtrue: tarkistaa kiintiön ja kustannuksen käynnistämättä mitään
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-palvelin agenteille
Yksi osoite https://cliponit.app/mcp, HTTP ”streamable”-muodossa. Työkalut kattavat molemmat tuotteet: klippien tuonti, odotus, luonti ja vienti, selitysvideon tuottaminen ja sen valmistumisen odottaminen. Muokkaavat työkalut on merkitty, jotta agentti kysyy ennen niiden käyttöä.
Claude Desktop ja Claude.ai: Asetukset → Liittimet → Lisää mukautettu liitin, käyttäen yllä olevaa osoitetta. Yhteys muodostetaan OAuthilla, eikä avainta tarvitse kopioida; ChatGPT toimii samoin. Vaiheittainen ohje
Videoiden tekeminen Claudella: työkalut, esimerkit, kiintiöt
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": {}}}'Saa ilmoituksen pyytämisen sijaan
Asetuksissa → Integraatiot lisää enintään 3 https-URL-osoitetta. Kun Explainer-tuotanto päättyy, ClipOnIt lähettää niihin job.done- tai job.failed-tapahtuman, jossa on sama objekti kuin GET /api/jobs/{id}:ssä. Kuusi yritystä epäonnistumisen sattuessa, noin 8 tunnin aikana.
Smart Clipper -klipeille ei ole vielä webhookia: seuraa tilaa GET-pyynnöllä.
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", ""))Rajat ja kiintiöt tilauksittain
API-kutsut lasketaan samalla tavalla kuin käyttöliittymässä: samat kiintiöt, sama tili. Katso hinnat
| Ilmainen | Starter | Pro | Business | |
|---|---|---|---|---|
| API ja MCP | — | ✓ | ✓ | ✓ |
| Explainer-videoita kuukaudessa | — | 15 | 30 | 100 |
| Samanaikaiset Explainer-tuotannot | — | 2 | 2 | 2 |
| Tilikohtaiset API-avaimet | — | 10 | 10 | 10 |
| Webhookit tilikohtaisesti | — | 3 | 3 | 3 |
- Avain pysyy palvelimellasi.Se antaa pääsyn koko ClipOnIt-tiliin: älä koskaan käytä selaimessa, mobiilisovelluksessa tai Git-arkistossa. Säilytä se ympäristömuuttujassa ja kutsu ClipOnItiä backendistäsi.
- Yksi avain per käyttö, rajauksineen.Laajuus ”lukeminen” (tarkistaminen) tai ”tuotanto” (videoiden luonti). Jokaisella avaimella on nimi ja päivämäärä viimeisestä käytöstä, ja sen voi peruuttaa yhdellä napsautuksella: se antaa vastauksen 401 heti seuraavasta kutsusta.
- Salaisuus näytetään vain kerran.ClipOnIt tallentaa vain sen tiivisteen (SHA-256). Kadonnut avain korvataan uudella, sitä ei voi lukea uudelleen.
- Allekirjoitetut webhookit.Jokainen lähetys sisältää X-ClipOnIt-Signature-otsikon (HMAC-SHA256 rungosta ja aikaleimasta); hylkää kaikki lähetykset, jotka ovat yli 5 minuuttia vanhoja. Vastaanotto-URL-osoitteet ovat https-muotoisia ja tarkistetaan jokaisella lähetyksellä.
- Isännöity Euroopan unionissa.Palvelimet Hetznerillä EU:ssa; alihankkijat on lueteltu tietosuojakäytännössä.
Usein kysytyt kysymykset
SDK, widget, viiveet, kiintiöt ja volyymi.
Mikä paketti tarvitaan API:lle?
Ilmainen paketti riittää alkuun: avain luodaan ja MCP-palvelin vastaa, 3 Explainer-videota kuukaudessa vesileimalla, 8 ilmaisessa tyylissä. Maksulliset paketit lisäävät videoita (15, 30 tai 100 kuukaudessa), ilman vesileimaa, 24 tyyliä, oma ääni mikrofonista ja AI-ohjaaja. API:n kiintiöt ovat tilin kiintiöt, kuten käyttöliittymässä.
Onko SDK:ta?
Virallista SDK:ta ei ole toistaiseksi. API on HTTP- ja JSON-muotoinen, ja se on kuvattu OpenAPI 3.1 -muodossa (/openapi.json). Tämän sivun esimerkit mahtuvat muutamaan riviin fetchia tai tavallista Pythonia, ja asiakasohjelman voi generoida OpenAPI-tiedostosta.
Voinko upottaa ClipOnItin soittimen tai editorin sivustolleni?
Ei, upotettavaa widgetiä ei ole. Haet MP4-tiedoston ja näytät sen omassa soittimessasi tai isännöit sen itse.
Kuinka kauan video kestää?
Selitysvideo: muutama minuutti (kirjoitus ja sen jälkeen renderöinti, noin 4 min renderöintiin). Klipit: noin 1–5 minuuttia 20 minuutin videolle, minkä jälkeen jokainen klippi viedään. API palauttaa vaiheen, prosentin ja arvion jäljellä olevasta ajasta.
Mitä tapahtuu, kun kiintiö täyttyy?
API vastaa 402 selkeällä viestillä (kuukausikiintiö tai tekoälybudjetti), 403 jos toiminto ei kuulu tilaukseesi ja 429 jos kaksi Explainer-tuotantoa on jo käynnissä. Explainerin kohdalla ”dry_run”: true tarkistaa kaiken ennen käynnistystä, eikä luo tai veloita mitään.
Haluan ottaa ClipOnItin käyttöön kaikille käyttäjilleni.
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.
Ensimmäinen videosi API:n kautta tänään
Crée une clé, copie un exemple, lance-le. Une question sur ton intégration : contact@cliponit.app.