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/produce

  • MCP

    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.

  1. Luo tehtävä

    POST-pyyntö aiheen tai videolinkin kanssa. Vastaus heti tunnisteella.

  2. Seuraa tilaa

    GET-pyyntö noin 10 s välein: vaihe, prosentti ja jäljellä oleva aika. Explainerin kohdalla webhook voi ilmoittaa sinulle sen sijaan.

  3. 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"

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"

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

IlmainenStarterProBusiness
API ja MCP—✓✓✓
Explainer-videoita kuukaudessa—1530100
Samanaikaiset Explainer-tuotannot—222
Tilikohtaiset API-avaimet—101010
Webhookit tilikohtaisesti—333

Tietoturva

Kutsu ClipOnItiä palvelimeltasi, älä koskaan käyttäjiesi selaimesta.

Tietosuojakäytäntö
  • 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.

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