አንድ POST render ን ወደ ወረፋ ያስገባል። record ን poll ያድርጉ ወይም የቀጥታ ሁኔታ 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 ን ያምጡ፣ ወይም ለቀጥታ ሁኔታ ዝማኔዎች 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 ፋይል ብቻ አይሰጥዎትም። ሰነድ ይሰጥዎታል። በተለቀቀው የማስተካከያ endpoint በኩል በቀላል ቋንቋ አንድ ማስተካከያ ይላኩ:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } ከሰከንዶች በኋላ አንድ ትዕይንት የተቀየረበት እና ሌላው ሁሉ ያልተነካበት አዲስ ቪዲዮ ይኖርዎታል። አዲሱ ስሪት በዚያው ማብራሪያ ታሪክ ውስጥ ይቆያል፣ ስለዚህ በ API በኩል ሊመረምሩት ወይም ሊመልሱት ይችላሉ።
Sketchie የ MCP አገልጋይ ያቀርባል፣ ስለዚህ ማንኛውም MCP-ችሎታ ያለው ወኪል የማብራሪያ ቪዲዮዎችን እንደ native መሣሪያዎች መፍጠር እና ማስተካከል ይችላል: ከሰነድ ይፍጠሩ፣ scene graph ን ይመርምሩ፣ ማስተካከያ ይጠይቁ፣ እንደገና render ያድርጉ። ከጽሑፍ ግድግዳ ይልቅ በቪዲዮ መመለስ ያለባቸውን ወኪሎች እየገነቡ ከሆነ፣ ይህ ያለው አጭሩ መንገድ ነው።
ከ GET /v1/voices Nora፣ Miles፣ Dean፣ Clara፣ Piper ወይም Wren ን ይምረጡ። Nora ሞቅ ያለ ነባሪ ተራኪ ናት፣ እና እያንዳንዱ የካታሎግ ድምጽ የሚደገፍ እያንዳንዱን ቋንቋ መናገር ይችላል። የድምጽ ቅድመ እይታዎች በካታሎግ ምላሽ ውስጥ ተካትተዋል።