आढावा आणि क्विकस्टार्ट

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 अ‍ॅपमध्ये साधने म्हणून वापरा.