Un POST met le rendu en file. Interrogez l’enregistrement ou écoutez le flux de statut en direct, puis recevez le MP4 et son scene graph complet et modifiable. Inclus à partir de Plus, décompté à 2x les minutes du forfait. Sans minimum.
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"
} La création est asynchrone. L’API répond immédiatement avec 202 Accepted et un enregistrement en file.
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
} Interrogez GET /v1/explainer/:id jusqu’à ce que l’enregistrement soit ready, ou abonnez-vous à GET /v1/explainer/events pour des mises à jour de statut en direct. L’enregistrement prêt porte l’URL du MP4 et le 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": [ ... ] }
} L’API ne vous tend pas juste un fichier. Elle vous tend un document. Envoyez une modification en langage naturel via l’endpoint d’édition livré :
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Quelques secondes plus tard, vous avez une nouvelle vidéo avec une scène changée et tout le reste intact. La nouvelle version reste dans l’historique du même explicatif, vous pouvez donc l’inspecter ou la revenir via l’API.
Sketchie livre un serveur MCP, donc tout agent compatible MCP peut générer et modifier des vidéos explicatives comme des outils natifs : générer depuis un document, inspecter le scene graph, demander une modification, re-rendre. Si vous construisez des agents qui devraient répondre par une vidéo plutôt qu’un mur de texte, c’est le chemin le plus court qui existe.
Choisissez Nora, Miles, Dean, Clara, Piper ou Wren dans GET /v1/voices. Nora est la narratrice chaleureuse par défaut, et chaque voix du catalogue peut parler toutes les langues prises en charge. Les aperçus de voix sont inclus dans la réponse du catalogue.