کتنه او چټک پیل

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 په توګه واستوئ (د "0:30" یا "1:00" په څیر ساده "M:SS" تار، په 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. د پایلې لپاره poll وکړئ

تشریحي ویډیو د 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 اپلیکیشن کې د وسیلو په توګه وکاروئ.