Um POST coloca o render na fila. Faça polling do registro ou ouça o stream de status ao vivo, e depois receba o MP4 e seu scene graph completo e editável. Incluído a partir do Plus, medido a 2x os minutos do plano. Sem mínimo.
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"
} A criação é assíncrona. A API responde imediatamente com 202 Accepted e um registro na fila.
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
} Busque GET /v1/explainer/:id até o registro ficar ready, ou assine GET /v1/explainer/events para atualizações de status ao vivo. O registro pronto carrega a URL do MP4 e o 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": [ ... ] }
} A API não te entrega só um arquivo. Ela te entrega um documento. Envie uma edição em linguagem simples pelo endpoint de edição já disponível:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Segundos depois você tem um vídeo novo com uma cena mudada e todo o resto intocado. A nova versão fica no histórico do mesmo explicativo, então você pode inspecioná-la ou revertê-la pela API.
A Sketchie inclui um servidor MCP, então qualquer agente compatível com MCP pode gerar e editar vídeos explicativos como ferramentas nativas: gerar a partir de um documento, inspecionar o scene graph, pedir uma edição, renderizar de novo. Se você constrói agentes que deveriam responder com vídeo em vez de um muro de texto, este é o caminho mais curto que existe.
Escolha Nora, Miles, Dean, Clara, Piper ou Wren em GET /v1/voices. Nora é a narradora calorosa padrão, e cada voz do catálogo pode falar todos os idiomas suportados. As prévias de voz vêm na resposta do catálogo.