نداء POST واحد يضع التصيير في قائمة الانتظار. استعلم عن السجل أو استمع إلى بث الحالة الحية، ثم استلم ملف MP4 وscene graph الكامل القابل للتحرير الخاص به. مضمَّن من Plus فأعلى، ويُحتسب بمعدل 2x من دقائق الخطة. بلا حد أدنى.
POST /v1/explainer
{
"input": "Explain how recurring billing works",
"length": "1:00", // optional, in 30-second steps up to "6:00"
"aspect": "16:9", // 16:9, 9:16, 1:1
"voice": "sketchie:sulafat", // Nora, the default narrator
"language": "en"
} الإنشاء غير متزامن. تستجيب واجهة API فورًا بـ 202 Accepted وسجل في قائمة الانتظار.
HTTP/1.1 202 Accepted
{
"id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
"status": "queued",
"prompt": "Explain how recurring billing works",
"lengthSeconds": 60,
"voice": "sketchie:sulafat",
"language": "en",
"aspect": "16:9",
"videoUrl": null,
"sceneGraph": null
} اجلب GET /v1/explainer/:id حتى يصبح السجل ready، أو اشترك في GET /v1/explainer/events للحصول على تحديثات الحالة الحية. يحمل السجل الجاهز عنوان URL لملف MP4 وscene graph.
GET /v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b
{
"id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
"status": "ready",
"videoUrl": "https://media.sketchie.ai/....mp4",
"sceneGraph": { "scenes": [ ... ] }
} لا تسلّمك واجهة API ملفًا فحسب. بل تسلّمك مستندًا. أرسل تحريرًا بلغة بسيطة عبر نقطة نهاية التحرير المتوفرة:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } بعد ثوانٍ يكون لديك فيديو جديد بمشهد واحد مُعدَّل وكل شيء آخر دون مساس. تبقى النسخة الجديدة في سجل الشرح نفسه، فيمكنك فحصها أو التراجع عنها عبر واجهة API.
يوفّر Sketchie خادم MCP، فيستطيع أي وكيل يدعم MCP إنشاء وتحرير فيديوهات الشرح كأدوات أصيلة: الإنشاء من مستند، وفحص scene graph، وطلب تحرير، وإعادة التصيير. إذا كنت تبني وكلاء ينبغي أن يجيبوا بالفيديو بدلًا من جدار من النص، فهذا أقصر مسار موجود.
اختر Nora أو Miles أو Dean أو Clara أو Piper أو Wren من GET /v1/voices. Nora هي الراوية الافتراضية الدافئة، وكل صوت في الكتالوج يمكنه التحدث بكل لغة مدعومة. تُضمَّن معاينات الأصوات في استجابة الكتالوج.