Tek bir POST render işlemini kuyruğa alır. Kaydı yoklayın veya canlı durum akışını dinleyin, ardından MP4 dosyasını ve tam düzenlenebilir scene graph verisini alın. Plus ve üzerinde dahildir, plan dakikalarının 2x oranında ölçülür. Minimum yok.
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"
} Oluşturma asenkrondur. API hemen 202 Accepted ve kuyruğa alınmış bir kayıtla yanıt 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
} Kayıt ready olana kadar GET /v1/explainer/:id alın ya da canlı durum güncellemeleri için GET /v1/explainer/events aboneliği yapın. Hazır kayıt MP4 URL adresini ve scene graph verisini taşı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 size sadece bir dosya vermez. Size bir belge verir. Yayınlanan düzenleme uç noktası üzerinden düz dille bir düzenleme gönderin:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Saniyeler sonra bir sahnesi değişmiş ve geri kalanı dokunulmamış yeni bir videonuz olur. Yeni sürüm aynı anlatımın geçmişinde kalır, böylece onu API üzerinden inceleyebilir veya geri alabilirsiniz.
Sketchie bir MCP sunucusu sunar, böylece MCP yeteneğine sahip her aracı anlatım videolarını yerel araçlar olarak oluşturup düzenleyebilir: bir belgeden oluşturun, scene graph verisini inceleyin, bir düzenleme isteyin, yeniden render edin. Bir metin duvarı yerine videoyla yanıt vermesi gereken aracılar geliştiriyorsanız, bu var olan en kısa yoldur.
GET /v1/voices üzerinden Nora, Miles, Dean, Clara, Piper veya Wren seçin. Nora sıcak varsayılan anlatıcıdır ve katalogdaki her ses, desteklenen her dili konuşabilir. Ses önizlemeleri katalog yanıtına dahildir.