POST אחד מכניס את הרינדור לתור. בצעו poll לרשומה או האזינו לזרם הסטטוס החי, ואז קבלו את ה-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 לא רק מגיש לכם קובץ. הוא מגיש לכם מסמך. שלחו עריכה בשפה פשוטה דרך endpoint העריכה שסופק:
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 היא המספרת החמה כברירת מחדל, וכל קול בקטלוג יכול לדבר בכל שפה נתמכת. תצוגות מקדימות של קול כלולות בתגובת הקטלוג.