एउटा 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
} रेकर्ड ready नभएसम्म GET /v1/explainer/:id ल्याउनुहोस्, वा लाइभ स्थिति अपडेटहरूका लागि GET /v1/explainer/events मा सदस्यता लिनुहोस्। तयार रेकर्डले MP4 URL र 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 जाँच्नुहोस्, सम्पादन अनुरोध गर्नुहोस्, पुनः रेन्डर गर्नुहोस्। यदि तपाईं पाठको पर्खालको सट्टा भिडियोले जवाफ दिनुपर्ने एजेन्टहरू निर्माण गर्दै हुनुहुन्छ भने, यो अवस्थित सबैभन्दा छोटो बाटो हो।
GET /v1/voices बाट Nora, Miles, Dean, Clara, Piper वा Wren छान्नुहोस्। Nora न्यानो पूर्वनिर्धारित वाचक हो, र क्याटलगको प्रत्येक आवाजले प्रत्येक समर्थित भाषा बोल्न सक्छ। आवाज पूर्वावलोकनहरू क्याटलग प्रतिक्रियामा समावेश छन्।