ခြုံငုံသုံးသပ်ချက်နှင့် အမြန်စတင်ခြင်း

Sketchie သည် prompt တစ်ခု သို့မဟုတ် စာရွက်စာတမ်းတစ်ခုကို ဝှိုက်ဘုတ်ရှင်းလင်းဗီဒီယိုအဖြစ် ပြောင်းလဲပြီး render လုပ်ထားသောဗီဒီယိုနှင့် ၎င်း၏ တည်းဖြတ်နိုင်သော scene graph နှစ်ခုစလုံးကို သင့်ထံ ပြန်ပေးသည်။ ဤသည်မှာ HTTP API, CLI, TypeScript SDK နှင့် MCP ဆာဗာအတွက် အကိုးအကားဖြစ်သည်။

API ဝင်ရောက်ခွင့်ကို ပေးချေမှုအစီအစဉ်တိုင်းတွင် ထည့်သွင်းထားသည်။ အစီအစဉ်တစ်ခုရှိသည်နှင့် အက်ပ်ရှိ ဆက်တင်များ မှ API key တစ်ခု ဖန်တီးပါ။ API ဖန်တီးမှုများသည် အက်ပ်နှင့် နှုန်းတူ သင့်အစီအစဉ်၏ မိနစ်များကို သုံးစွဲသည်။ သီးခြား API ဈေးနှုန်း မရှိပါ။

အထောက်အထားစိစစ်ခြင်း

တောင်းဆိုမှုတိုင်းကို သင့် API key ကို Bearer token အဖြစ် အထောက်အထားစိစစ်သည်။ အက်ပ်တွင် ဆက်တင်များ အောက်တွင် key တစ်ခု ဖန်တီးပြီး၊ ၎င်းကို Authorization header တွင် ပို့ပါ-

တောင်းဆိုမှု header 
Authorization: Bearer sk_...

key ကို ဖန်တီးချိန်တွင် တစ်ကြိမ် ပြသသည်။ ၎င်းကို လျှို့ဝှက်ထားပါ။ endpoint တိုင်း၏ base URL မှာ https://sketchie.ai/api ဖြစ်သည်။

အမြန်စတင်ခြင်း

1. ရှင်းလင်းဗီဒီယိုတစ်ခု ဖန်တီးပါ

သင့်ခေါင်းစဉ်ကို input အဖြစ်နှင့် ရွေးချယ်နိုင်သော ပစ်မှတ်အရှည်ကို length အဖြစ် ပို့ပါ ("0:30" သို့မဟုတ် "1:00" ကဲ့သို့ ရိုးရှင်းသော "M:SS" string, စက္ကန့် 30 အဆင့်ဖြင့်)။ အလိုအလျောက်အရှည်အတွက် length ကို ချန်လှပ်ပါ။

Terminal 
curl -X POST https://sketchie.ai/api/v1/explainer \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Explain how DNS resolves a domain name",
    "length": "0:30"
  }'

ခေါ်ဆိုမှုသည် တန်းစီထားသော record တစ်ခုဖြင့် ချက်ချင်း 202 Accepted ကို ပြန်ပေးသည်။ rendering သည် နောက်ခံတွင် လုပ်ဆောင်ပြီး မိနစ်အနည်းငယ် ကြာသည်။

202 Accepted 
{
  "id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
  "status": "queued",
  "prompt": "Explain how DNS resolves a domain name",
  "lengthSeconds": 30,
  "voice": "sketchie:sulafat",
  "language": "en",
  "aspect": "16:9",
  "videoUrl": null,
  "sceneGraph": null
}

2. ရလဒ်အတွက် poll လုပ်ပါ

ရှင်းလင်းဗီဒီယိုကို ၎င်း၏ status နောက်ဆုံးအခြေအနေသို့ ရောက်သည်အထိ id ဖြင့် ရယူပါ။ သက်တမ်းစက်ဝန်းမှာ queued, ထို့နောက် generating, ထို့နောက် rendering, ထို့နောက် ready (ပြီး) သို့မဟုတ် failed ဖြစ်သည်။

Terminal 
curl https://sketchie.ai/api/v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b \
  -H "Authorization: Bearer sk_..."

၎င်းသည် ready ဖြစ်သည့်အခါ record သည် ဗီဒီယို URL နှင့် တည်းဖြတ်နိုင်သော scene graph ကို သယ်ဆောင်သည်-

200 OK 
{
  "id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
  "status": "ready",
  "videoUrl": "https://sketchie.ai/media/....mp4",
  "sceneGraph": { "scenes": [ ... ] }
}

ရိုးရှင်းသော နှင့် ရိုးရာ field အမည်များ။ input နှင့် length သည် ရိုးရှင်းသော တောင်းဆိုမှု field များဖြစ်သည်။ ဟောင်းသော prompt (string) နှင့် lengthSeconds (ဂဏန်း၊ 30 ၏ အပေါင်းဆမြောက်) ကို alias အဖြစ် ဆက်လက်လက်ခံသေးသဖြင့် လက်ရှိ integration များ ဆက်လက်အလုပ်လုပ်သည်။ နှစ်ခုစလုံး ပို့သည့်အခါ ရိုးရှင်းသော field က နိုင်သည်။

နောက်ထပ် ဘယ်ကိုသွားမည်နည်း

  • API အကိုးအကား . endpoint တိုင်း၊ ၎င်း၏ တောင်းဆိုမှုနှင့် တုံ့ပြန်မှုပုံစံများနှင့်အတူ။
  • အသံများ . မူရင်း ဇာတ်ကြောင်းပြောသူ၊ အသံခြောက်ခု ကက်တလောက်၊ နှင့် ဖွင့်နိုင်သော အစမ်းကြည့်ရှုမှုများ။
  • ဘာသာစကားများ . ပံ့ပိုးထားသော ဇာတ်ကြောင်းပြော ဘာသာစကား 34 ခု။
  • CLI နှင့် SDK . sketchie command line နှင့် @sketchie/sdk TypeScript client။
  • MCP တပ်ဆင်ခြင်း . Sketchie ကို Claude Desktop, Claude Code နှင့် Claude အက်ပ်တွင် tool များအဖြစ် သုံးပါ။