یک 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، درخواست ویرایش، رندر دوباره. اگر عاملهایی میسازید که باید بهجای دیواری از متن با ویدیو پاسخ دهند، این کوتاهترین مسیر موجود است.
از GET /v1/voices یکی از Nora، Miles، Dean، Clara، Piper یا Wren را انتخاب کنید. Nora راوی پیشفرض گرم است و هر صدای کاتالوگ میتواند به هر زبان پشتیبانیشده صحبت کند. پیشنمایشهای صدا در پاسخ کاتالوگ گنجانده شدهاند.