Satu POST membariskan render. Poll rekod atau dengar strim status langsung, kemudian terima MP4 dan scene graph boleh suntingnya sepenuhnya. Disertakan dari Plus ke atas, ditakar pada 2x minit pelan. Tiada 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"
} Penciptaan adalah tak segerak. API membalas serta-merta dengan 202 Accepted dan rekod dalam baris gilir.
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 sehingga rekod ialah ready, atau langgan GET /v1/explainer/events untuk kemas kini status langsung. Rekod yang sedia 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 fail kepada anda. Ia menyerahkan dokumen. Hantar suntingan dalam bahasa mudah melalui endpoint suntingan yang telah dihantar:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Beberapa saat kemudian anda mempunyai video baharu dengan satu adegan berubah dan segala yang lain tidak tersentuh. Versi baharu kekal dalam sejarah penerang yang sama, jadi anda boleh memeriksanya atau memulihkannya melalui API.
Sketchie menghantar pelayan MCP, jadi mana-mana ejen yang berkemampuan MCP boleh menjana dan menyunting video penerang sebagai alat asli: jana daripada dokumen, periksa scene graph, minta suntingan, render semula. Jika anda membina ejen yang sepatutnya menjawab dengan video dan bukannya dinding teks, ini ialah laluan terpendek yang wujud.
Pilih Nora, Miles, Dean, Clara, Piper atau Wren dari GET /v1/voices. Nora ialah pencerita lalai yang mesra, dan setiap suara katalog boleh bertutur dalam setiap bahasa yang disokong. Pratonton suara disertakan dalam respons katalog.