એક 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 ઉષ્માભર્યો ડિફૉલ્ટ વર્ણનકાર છે, અને કૅટલૉગનો દરેક અવાજ દરેક સમર્થિત ભાષા બોલી શકે છે. અવાજ પૂર્વાવલોકનો કૅટલૉગ પ્રતિસાદમાં સામેલ છે.