දළ විශ්ලේෂණය සහ ඉක්මන් ආරම්භය

Sketchie මඟින් prompt එකක් හෝ ලේඛනයක් වයිට්බෝඩ් පැහැදිලි කිරීමේ වීඩියෝවක් බවට පරිවර්තනය කරන අතර, render කළ වීඩියෝව සහ එහි සංස්කරණය කළ හැකි scene graph යන දෙකම ඔබට ලබා දෙයි. මෙය HTTP API, CLI, TypeScript SDK සහ MCP සේවාදායකය සඳහා යොමුවයි.

සෑම ගෙවන සැලසුමකම API ප්‍රවේශය ඇතුළත් වේ. සැලසුමක් ලබා ගත් පසු යෙදුමේ සැකසුම් වලින් API යතුරක් සාදන්න. API උත්පාදන යෙදුම මෙන් එකම අනුපාතයෙන් ඔබේ සැලසුමේ මිනිත්තු භාවිතා කරයි. වෙනම API මිලක් නැත.

සත්‍යාපනය

සෑම ඉල්ලීමක්ම ඔබේ API යතුර Bearer ටෝකනයක් ලෙස සත්‍යාපනය කරයි. යෙදුමේ සැකසුම් යටතේ යතුරක් සාදා, පසුව එය Authorization ශීර්ෂකයෙහි යවන්න:

ඉල්ලීම් ශීර්ෂකය 
Authorization: Bearer sk_...

යතුර සෑදීමේදී එක් වරක් පෙන්වයි. එය රහසිගතව තබා ගන්න. සෑම endpoint එකකම මූලික 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"
  }'

ඇමතුම පෝලිමේ ඇති වාර්තාවක් සමඟ වහාම 202 Accepted ලබා දෙයි. render කිරීම පසුබිමින් ක්‍රියාත්මක වන අතර මිනිත්තු කිහිපයක් ගත වේ.

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 වූ විට, වාර්තාව වීඩියෝ URL එක සහ සංස්කරණය කළ හැකි scene graph එක රැගෙන යයි:

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

සරල සහ සම්භාව්‍ය ක්ෂේත්‍ර නම්. input සහ length යනු සරල ඉල්ලීම් ක්ෂේත්‍ර වේ. පැරණි prompt (string) සහ lengthSeconds (අංකයක්, 30 හි ධන ගුණාකාරයක්) තවමත් අන්වර්ථ ලෙස පිළිගනී, එබැවින් පවතින ඒකාබද්ධ කිරීම් දිගටම ක්‍රියා කරයි. දෙකම යවන විට, සරල ක්ෂේත්‍රය ජය ගනී.

ඊළඟට කොහේ යා යුතුද

  • API යොමුව . සෑම endpoint එකක්ම, එහි ඉල්ලීම් සහ ප්‍රතිචාර හැඩතල සමඟ.
  • හඬ . පෙරනිමි කථකයා, හඬ හයක නාමාවලිය, සහ වාදනය කළ හැකි පෙරදසුන්.
  • භාෂා . සහාය දක්වන කථන භාෂා 34.
  • CLI සහ SDK . sketchie විධාන රේඛාව සහ @sketchie/sdk TypeScript සේවාදායකයා.
  • MCP සැකසුම . Sketchie Claude Desktop, Claude Code සහ Claude යෙදුමේ මෙවලම් ලෙස භාවිතා කරන්න.