סקירה כללית והתחלה מהירה

אימות

כל בקשה מאומתת עם מפתח ה-API שלכם כאסימון Bearer. צרו מפתח באפליקציה תחת ההגדרות, ואז שלחו אותו בכותרת Authorization:

Authorization: Bearer sk_...

המפתח מוצג פעם אחת, בעת היצירה. שמרו אותו בסוד. כתובת ה-URL הבסיסית של כל endpoint היא https://sketchie.ai/api.

התחלה מהירה

1. צרו סרטון הסבר

שלחו את הנושא שלכם כ-input ואורך יעד אופציונלי כ-length (מחרוזת "M:SS" ידידותית כמו "0:30" או "1:00", בצעדים של 30 שניות). השמיטו את length לאורך אוטומטי.

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 מיד עם רשומה בתור. הרינדור רץ ברקע ולוקח כמה דקות.

{
  "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.

curl https://sketchie.ai/api/v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b \
  -H "Authorization: Bearer sk_..."

כשהוא ready, הרשומה נושאת את כתובת ה-URL של הסרטון ואת ה-scene graph הניתן לעריכה:

{
  "id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
  "status": "ready",
  "videoUrl": "https://sketchie.ai/media/....mp4",
  "sceneGraph": { "scenes": [ ... ] }
}

לאן להמשיך

• עיון API . כל endpoint, עם צורות הבקשה והתגובה.
• קולות . המספר המוגדר כברירת מחדל, קטלוג ששת הקולות, ותצוגות מקדימות הניתנות לנגינה.
• שפות . 34 שפות הקריינות הנתמכות.
• CLI ו-SDK . שורת הפקודה sketchie ולקוח ה-TypeScript @sketchie/sdk.
• הגדרת MCP . השתמשו ב-Sketchie ככלים ב-Claude Desktop, ב-Claude Code ובאפליקציית Claude.