POST တစ်ခုသည် render ကို တန်းစီထားသည်။ record ကို poll လုပ်ပါ သို့မဟုတ် live status stream ကို နားထောင်ပါ၊ ထို့နောက် 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"
} ဖန်တီးမှုသည် asynchronous ဖြစ်သည်။ API သည် ချက်ချင်း 202 Accepted နှင့် တန်းစီထားသော record တစ်ခုဖြင့် တုံ့ပြန်သည်။
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
} record သည် ready ဖြစ်သည်အထိ GET /v1/explainer/:id ကို ရယူပါ၊ သို့မဟုတ် live status အပ်ဒိတ်များအတွက် GET /v1/explainer/events ကို စာရင်းသွင်းပါ။ အသင့်ဖြစ်သော record သည် 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 သည် သင့်ကို ဖိုင်တစ်ခုသာ မပေးပါ။ ၎င်းသည် သင့်ကို စာရွက်စာတမ်းတစ်ခု ပေးသည်။ ထုတ်ဝေထားသော edit endpoint မှတစ်ဆင့် ရိုးရှင်းသောဘာသာဖြင့် တည်းဖြတ်မှုတစ်ခု ပို့ပါ-
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } စက္ကန့်အနည်းငယ်အကြာတွင် သင့်တွင် မြင်ကွင်းတစ်ခု ပြောင်းလဲပြီး ကျန်အားလုံး မထိတွေ့သော ဗီဒီယိုအသစ်တစ်ခု ရှိသည်။ ဗားရှင်းအသစ်သည် တူညီသော ရှင်းလင်းချက်၏ မှတ်တမ်းတွင် ဆက်ရှိနေသဖြင့်၊ ၎င်းကို API မှတစ်ဆင့် စစ်ဆေးနိုင် သို့မဟုတ် ပြန်ရနိုင်သည်။
Sketchie သည် MCP ဆာဗာတစ်ခု ပေးသည်၊ ထို့ကြောင့် MCP-စွမ်းဆောင်နိုင်သော မည်သည့်အေးဂျင့်မဆို ရှင်းလင်းဗီဒီယိုများကို native tools အဖြစ် ဖန်တီးပြီး တည်းဖြတ်နိုင်သည်- စာရွက်စာတမ်းမှ ဖန်တီးပါ၊ scene graph ကို စစ်ဆေးပါ၊ တည်းဖြတ်မှု တောင်းဆိုပါ၊ ပြန်လည် render လုပ်ပါ။ စာသားနံရံအစား ဗီဒီယိုဖြင့် ဖြေဆိုသင့်သော အေးဂျင့်များကို သင်တည်ဆောက်နေပါက၊ ဤသည်မှာ ရှိသော အတိုဆုံးလမ်းကြောင်းဖြစ်သည်။
GET /v1/voices မှ Nora, Miles, Dean, Clara, Piper သို့မဟုတ် Wren ကို ရွေးပါ။ Nora သည် နွေးထွေးသော မူရင်း ဇာတ်ကြောင်းပြောသူဖြစ်ပြီး၊ ကက်တလောက်ရှိ အသံတိုင်းသည် ပံ့ပိုးထားသော ဘာသာစကားတိုင်းကို ပြောနိုင်သည်။ အသံ အစမ်းကြည့်ရှုမှုများသည် ကက်တလောက် တုံ့ပြန်မှုတွင် ပါဝင်သည်။