एक 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 उबदार डीफॉल्ट निवेदक आहे, आणि कॅटलॉगमधील प्रत्येक आवाज प्रत्येक समर्थित भाषा बोलू शकतो. आवाज पूर्वावलोकने कॅटलॉग प्रतिसादात समाविष्ट आहेत.