ایک POST رینڈر کو قطار میں ڈالتا ہے۔ ریکارڈ کو پول کریں یا لائیو اسٹیٹس اسٹریم سنیں، پھر 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"
} تخلیق غیر ہم وقت ساز ہے۔ API فوراً 202 Accepted اور ایک قطار بند ریکارڈ کے ساتھ جواب دیتا ہے۔
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
} ریکارڈ کے ready ہونے تک GET /v1/explainer/:id لائیں، یا لائیو اسٹیٹس اپڈیٹس کے لیے GET /v1/explainer/events کو سبسکرائب کریں۔ تیار ریکارڈ 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 آپ کو صرف ایک فائل نہیں دیتا۔ یہ آپ کو ایک دستاویز دیتا ہے۔ جاری کردہ ایڈٹ اینڈپوائنٹ کے ذریعے سادہ زبان میں ایک ترمیم بھیجیں:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } چند سیکنڈ بعد آپ کے پاس ایک نئی ویڈیو ہوتی ہے جس میں ایک منظر بدلا ہوا اور باقی سب اچھوتا۔ نیا ورژن اسی وضاحت کی تاریخ میں رہتا ہے، لہٰذا آپ اسے API کے ذریعے جانچ یا واپس کر سکتے ہیں۔
Sketchie ایک MCP سرور فراہم کرتا ہے، لہٰذا کوئی بھی MCP-قابل ایجنٹ وضاحتی ویڈیوز کو مقامی ٹولز کے طور پر بنا اور ترمیم کر سکتا ہے: ایک دستاویز سے بنائیں، scene graph جانچیں، ترمیم کی درخواست کریں، دوبارہ رینڈر کریں۔ اگر آپ ایسے ایجنٹ بنا رہے ہیں جنہیں متن کی دیوار کے بجائے ویڈیو سے جواب دینا چاہیے، تو یہ موجود سب سے مختصر راستہ ہے۔
GET /v1/voices سے Nora، Miles، Dean، Clara، Piper، یا Wren چنیں۔ Nora گرم طے شدہ راوی ہے، اور کیٹلاگ کی ہر آواز ہر معاون زبان بول سکتی ہے۔ آواز کی جھلکیاں کیٹلاگ کے جواب میں شامل ہیں۔