Jeden POST kolejkuje render. Odpytuj rekord lub słuchaj strumienia statusu na żywo, a potem odbierz plik MP4 i jego pełny edytowalny scene graph. Wliczone od Plus wzwyż, rozliczane po 2x minut planu. Bez minimum.
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"
} Tworzenie jest asynchroniczne. API natychmiast odpowiada 202 Accepted i rekordem w kolejce.
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
} Pobieraj GET /v1/explainer/:id, aż rekord będzie ready, lub subskrybuj GET /v1/explainer/events, aby otrzymywać aktualizacje statusu na żywo. Gotowy rekord niesie URL pliku MP4 i 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": [ ... ] }
} API nie wręcza ci tylko pliku. Wręcza ci dokument. Wyślij edycję w prostym języku przez wdrożony endpoint edycji:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Kilka sekund później masz nowe wideo z jedną zmienioną sceną i całą resztą nietkniętą. Nowa wersja pozostaje w historii tego samego objaśnienia, więc możesz ją sprawdzić lub przywrócić przez API.
Sketchie dostarcza serwer MCP, więc każdy agent obsługujący MCP może generować i edytować wideo objaśniające jako natywne narzędzia: generuj z dokumentu, sprawdzaj scene graph, poproś o edycję, renderuj ponownie. Jeśli budujesz agentów, którzy powinni odpowiadać wideo zamiast ścianą tekstu, to najkrótsza istniejąca droga.
Wybierz Nora, Miles, Dean, Clara, Piper lub Wren z GET /v1/voices. Nora to ciepły domyślny narrator, a każdy głos z katalogu potrafi mówić w każdym obsługiwanym języku. Podglądy głosów są zawarte w odpowiedzi katalogu.