Ein POST reiht den Render ein. Frage den Datensatz ab oder höre den Live-Status-Stream, dann erhalte das MP4 und seinen vollständigen editierbaren Scene Graph. Ab Plus inklusive, mit 2x Planminuten berechnet. Kein Mindestbetrag.
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"
} Das Erstellen ist asynchron. Die API antwortet sofort mit 202 Accepted und einem eingereihten Datensatz.
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
} Rufe GET /v1/explainer/:id ab, bis der Datensatz ready ist, oder abonniere GET /v1/explainer/events für Live-Status-Updates. Der fertige Datensatz trägt die MP4-URL und den Scene Graph.
GET /v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b
{
"id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
"status": "ready",
"videoUrl": "https://media.sketchie.ai/....mp4",
"sceneGraph": { "scenes": [ ... ] }
} Die API reicht dir nicht nur eine Datei. Sie reicht dir ein Dokument. Schick eine Bearbeitung in einfacher Sprache über den ausgelieferten Edit-Endpunkt:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Sekunden später hast du ein neues Video mit einer geänderten Szene und allem anderen unangetastet. Die neue Version bleibt im Verlauf desselben Erklärvideos, sodass du sie über die API prüfen oder zurücksetzen kannst.
Sketchie liefert einen MCP-Server, sodass jeder MCP-fähige Agent Erklärvideos als native Tools generieren und bearbeiten kann: aus einem Dokument generieren, den Scene Graph prüfen, eine Bearbeitung anfordern, neu rendern. Wenn du Agenten baust, die mit Video statt einer Textwand antworten sollen, ist das der kürzeste Weg, den es gibt.
Wähle Nora, Miles, Dean, Clara, Piper oder Wren aus GET /v1/voices. Nora ist die warme Standard-Erzählstimme, und jede Katalogstimme kann jede unterstützte Sprache sprechen. Stimm-Vorschauen sind in der Katalogantwort enthalten.