Један POST ставља рендеровање у ред. Анкетирајте запис или слушајте уживо ток статуса, а затим примите MP4 и његов потпуно измењив scene graph. Укључено од Plus навише, мери се на 2x минута плана. Без минимума.
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"
} Креирање је асинхроно. API одмах одговара са 202 Accepted и записом у реду.
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
} Преузимајте GET /v1/explainer/:id док запис не буде ready, или се претплатите на GET /v1/explainer/events за уживо ажурирања статуса. Готов запис носи URL MP4-а и 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 вам не пружа само датотеку. Пружа вам документ. Пошаљите уређивање на једноставном језику преко испоручене крајње тачке за уређивање:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Секунде касније имате нови видео са једном промењеном сценом и свим осталим нетакнутим. Нова верзија остаје у историји истог објашњења, па је можете прегледати или вратити преко API-ја.
Sketchie испоручује MCP сервер, тако да било који агент који подржава MCP може да генерише и уређује видее објашњења као изворне алате: генеришите из документа, прегледајте scene graph, затражите уређивање, поново рендерујте. Ако градите агенте који би требало да одговарају видеом уместо зидом текста, ово је најкраћи пут који постоји.
Изаберите Nora, Miles, Dean, Clara, Piper или Wren из GET /v1/voices. Nora је топао подразумевани приповедач, а сваки глас из каталога може да говори сваки подржани језик. Прегледи гласова укључени су у одговор каталога.