अवलोकन और क्विकस्टार्ट

Sketchie एक प्रॉम्प्ट या दस्तावेज़ को व्हाइटबोर्ड व्याख्यात्मक वीडियो में बदलता है, और आपको रेंडर किया हुआ वीडियो तथा उसका संपादन-योग्य scene graph दोनों लौटाता है। यह HTTP API, CLI, TypeScript SDK और MCP सर्वर के लिए संदर्भ है।

API एक्सेस हर सशुल्क प्लान में शामिल है। प्लान लेने के बाद ऐप के सेटिंग्स से एक API कुंजी बनाएं। API जनरेशन आपके प्लान के मिनट उसी दर से खर्च करता है जैसे ऐप। कोई अलग API मूल्य नहीं है।

प्रमाणीकरण

हर अनुरोध आपकी API कुंजी को Bearer टोकन के रूप में प्रमाणित करता है। ऐप में सेटिंग्स के तहत एक कुंजी बनाएं, फिर उसे Authorization हेडर में भेजें:

अनुरोध हेडर 
Authorization: Bearer sk_...

कुंजी बनाते समय एक बार दिखाई जाती है। इसे गुप्त रखें। हर एंडपॉइंट का बेस 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 संदर्भ . हर एंडपॉइंट, उसके अनुरोध और प्रतिक्रिया के आकार के साथ।
  • आवाज़ें . डिफ़ॉल्ट वाचक, छह-आवाज़ का कैटलॉग, और चलाने योग्य पूर्वावलोकन।
  • भाषाएं . समर्थित 34 वाचन भाषाएं।
  • CLI और SDK . sketchie कमांड लाइन और @sketchie/sdk TypeScript क्लाइंट।
  • MCP सेटअप . Sketchie को Claude Desktop, Claude Code और Claude ऐप में टूल के रूप में उपयोग करें।