Bir POST render-i növbəyə qoyur. Qeydi poll edin və ya canlı status axınına qulaq asın, sonra MP4-ü və onun tam redaktə edilə bilən scene graph-ını qəbul edin. Plus-dan yuxarı daxildir, plan dəqiqələrinin 2x-ində ölçülür. Minimum yoxdur.
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"
} Yaradılma asinxrondur. API dərhal 202 Accepted və növbədə olan qeydlə cavab verir.
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
} Qeyd ready olana qədər GET /v1/explainer/:id əldə edin, və ya canlı status yeniləmələri üçün GET /v1/explainer/events-ə abunə olun. Hazır qeyd MP4 URL-ini və scene graph-ı daşıyır.
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 sizə sadəcə fayl vermir. O sizə sənəd verir. Göndərilmiş redaktə endpoint-i vasitəsilə sadə dildə bir redaktə göndərin:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Saniyələr sonra bir səhnəsi dəyişmiş və qalan hər şeyi toxunulmamış yeni videonuz olur. Yeni versiya eyni izahatın tarixçəsində qalır, ona görə onu API vasitəsilə yoxlaya və ya geri qaytara bilərsiniz.
Sketchie MCP serveri göndərir, ona görə MCP dəstəkləyən istənilən agent izahedici videoları doğma alətlər kimi yarada və redaktə edə bilər: sənəddən yaradın, scene graph-ı yoxlayın, redaktə tələb edin, yenidən render edin. Mətn divarı əvəzinə video ilə cavab verməli olan agentlər qurursunuzsa, bu mövcud ən qısa yoldur.
GET /v1/voices-dən Nora, Miles, Dean, Clara, Piper və ya Wren seçin. Nora isti standart danışandır, və kataloqdakı hər səs dəstəklənən hər dildə danışa bilər. Səs önizləmələri kataloq cavabına daxildir.