جائزہ اور فوری آغاز

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 کے طور پر بھیجیں (ایک آسان "M:SS" سٹرنگ جیسے "0:30" یا "1:00"، 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. نتیجے کے لیے پول کریں

وضاحتی ویڈیو کو 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 ایپ میں بطور ٹولز استعمال کریں۔