نظرة عامة والبدء السريع

المصادقة

يُصادَق على كل طلب باستخدام مفتاح API الخاص بك كرمز Bearer. أنشئ مفتاحًا في التطبيق ضمن الإعدادات، ثم أرسله في ترويسة Authorization:

Authorization: Bearer sk_...

يُعرض المفتاح مرة واحدة، عند الإنشاء. أبقِه سريًا. عنوان URL الأساسي لكل نقطة نهاية هو 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. استعلم عن النتيجة

اجلب فيديو الشرح بالـ 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 . كل نقطة نهاية، مع أشكال الطلب والاستجابة.
• الأصوات . الراوي الافتراضي، وكتالوج الأصوات الستة، والمعاينات القابلة للتشغيل.
• اللغات . لغات السرد الـ 34 المدعومة.
• CLI وSDK . سطر أوامر sketchie وعميل @sketchie/sdk بلغة TypeScript.
• إعداد MCP . استخدم Sketchie كأدوات في Claude Desktop وClaude Code وتطبيق Claude.