Satu POST mengantrekan render. Pantau catatannya atau dengarkan aliran status langsung, lalu terima MP4 dan scene graph lengkap yang bisa diedit. Termasuk dari Plus ke atas, ditakar 2x menit paket. Tanpa 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"
} Pembuatan bersifat asinkron. API merespons langsung dengan 202 Accepted dan sebuah catatan yang mengantre.
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
} Ambil GET /v1/explainer/:id sampai catatannya ready, atau berlangganan GET /v1/explainer/events untuk pembaruan status langsung. Catatan yang siap membawa URL MP4 dan 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 tidak sekadar menyerahkan berkas. Ia menyerahkan sebuah dokumen. Kirim editan berbahasa sehari-hari lewat endpoint edit yang sudah tersedia:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Beberapa detik kemudian Anda punya video baru dengan satu adegan berubah dan semua lainnya utuh. Versi baru tetap ada di riwayat penjelas yang sama, jadi Anda bisa memeriksanya atau mengembalikannya lewat API.
Sketchie menyertakan server MCP, jadi agen apa pun yang mendukung MCP bisa membuat dan mengedit video penjelas sebagai alat native: membuat dari dokumen, memeriksa scene graph, meminta editan, merender ulang. Jika Anda membangun agen yang seharusnya menjawab dengan video alih-alih tembok teks, ini jalur terpendek yang ada.
Pilih Nora, Miles, Dean, Clara, Piper, atau Wren dari GET /v1/voices. Nora adalah narator hangat bawaan, dan setiap suara katalog bisa berbicara di semua bahasa yang didukung. Pratinjau suara disertakan dalam respons katalog.