Yksi POST asettaa renderöinnin jonoon. Pollaa tietuetta tai kuuntele reaaliaikaista tilavirtaa, ja vastaanota sitten MP4 ja sen täysin muokattava scene graph. Sisältyy Plus-tasosta ylöspäin, mitataan 2x tilausminuutteina. Ei vähimmäismäärää.
POST /v1/explainer
{
"input": "Explain how recurring billing works",
"length": "1:00", // optional, in 30-second steps up to "6:00"
"aspect": "16:9", // 16:9, 9:16, 1:1
"voice": "sketchie:sulafat", // Nora, the default narrator
"language": "en"
} Luonti on asynkroninen. API vastaa heti 202 Accepted ja jonossa olevalla tietueella.
HTTP/1.1 202 Accepted
{
"id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
"status": "queued",
"prompt": "Explain how recurring billing works",
"lengthSeconds": 60,
"voice": "sketchie:sulafat",
"language": "en",
"aspect": "16:9",
"videoUrl": null,
"sceneGraph": null
} Nouda GET /v1/explainer/:id, kunnes tietue on ready, tai tilaa GET /v1/explainer/events reaaliaikaisia tilapäivityksiä varten. Valmis tietue kantaa MP4-URL:n ja scene graphin.
GET /v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b
{
"id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
"status": "ready",
"videoUrl": "https://media.sketchie.ai/....mp4",
"sceneGraph": { "scenes": [ ... ] }
} API ei anna sinulle vain tiedostoa. Se antaa sinulle asiakirjan. Lähetä yksinkertaisella kielellä tehty muokkaus julkaistun muokkauspäätepisteen kautta:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Sekunteja myöhemmin sinulla on uusi video, jossa yksi kohtaus on muuttunut ja kaikki muu koskematonta. Uusi versio jää saman selityksen historiaan, joten voit tarkastaa tai palauttaa sen API:n kautta.
Sketchie toimittaa MCP-palvelimen, joten mikä tahansa MCP:tä tukeva agentti voi luoda ja muokata selitysvideoita natiivityökaluina: luo asiakirjasta, tarkasta scene graph, pyydä muokkausta, renderöi uudelleen. Jos rakennat agentteja, joiden pitäisi vastata videolla tekstiseinän sijaan, tämä on lyhin olemassa oleva reitti.
Valitse Nora, Miles, Dean, Clara, Piper tai Wren kohteesta GET /v1/voices. Nora on lämmin oletuskertoja, ja jokainen luettelon ääni osaa puhua jokaista tuettua kieltä. Ääninäytteet sisältyvät luettelon vastaukseen.