አጠቃላይ እይታ እና ፈጣን ጅምር

Sketchie prompt ወይም ሰነድን ወደ ነጭ ሰሌዳ ማብራሪያ ቪዲዮ ይቀይራል፣ እና የተቀነባበረውን ቪዲዮ እና ሊስተካከል የሚችለውን 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" ሕብረቁምፊ፣ በ 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 ይመልሳል። ማቀነባበሩ በጀርባ ይሠራል እና ጥቂት ደቂቃዎችን ይወስዳል።

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 ያድርጉ

ማብራሪያ ቪዲዮውን በ id ያምጡ status የመጨረሻ ሁኔታ እስኪደርስ ድረስ። የሕይወት ዑደቱ 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 (ሕብረቁምፊ) እና lengthSeconds (ቁጥር፣ የ 30 አዎንታዊ ብዜት) አሁንም እንደ ተለዋጭ ስሞች ተቀባይነት አላቸው፣ ስለዚህ ነባር ውህደቶች መስራታቸውን ይቀጥላሉ። ሁለቱም ሲላኩ፣ ቀላሉ መስክ ያሸንፋል።

ቀጥሎ ወዴት መሄድ

  • የ API ማጣቀሻ . እያንዳንዱ endpoint፣ ከጥያቄ እና ምላሽ ቅርጾቹ ጋር።
  • ድምጾች . ነባሪ ተራኪ፣ የስድስት ድምጽ ካታሎግ፣ እና ሊጫወቱ የሚችሉ ቅድመ እይታዎች።
  • ቋንቋዎች . የሚደገፉ 34 የትረካ ቋንቋዎች።
  • CLI እና SDK . የ sketchie ትዕዛዝ መስመር እና የ @sketchie/sdk TypeScript ደንበኛ።
  • የ MCP ማዋቀር . Sketchie ን በ Claude Desktop፣ Claude Code እና Claude መተግበሪያ ውስጥ እንደ መሣሪያ ይጠቀሙ።