Aperçu et démarrage rapide

Sketchie transforme un prompt ou un document en une vidéo explicative de tableau blanc, et vous rend à la fois la vidéo rendue et son scene graph modifiable. Ceci est la référence de l’API HTTP, de la CLI, du SDK TypeScript et du serveur MCP.

L’accès API est inclus dans tout forfait payant. Créez une clé API depuis les Paramètres de l’application une fois sur un forfait. Les générations via API puisent dans les minutes de votre forfait au même tarif que l’application. Il n’y a pas de prix API séparé.

Authentification

Chaque requête est authentifiée avec votre clé API comme jeton Bearer. Créez une clé dans l’application sous Paramètres, puis envoyez-la dans l’en-tête Authorization :

En-tête de requête 
Authorization: Bearer sk_...

La clé est affichée une fois, à la création. Gardez-la secrète. L’URL de base de chaque endpoint est https://sketchie.ai/api.

Démarrage rapide

1. Créez un explicatif

Envoyez votre sujet comme input et une durée cible optionnelle comme length (une chaîne conviviale "M:SS" comme "0:30" ou "1:00", par paliers de 30 secondes). Omettez length pour une durée automatique.

Terminal 
curl -X POST https://sketchie.ai/api/v1/explainer \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Explain how DNS resolves a domain name",
    "length": "0:30"
  }'

L’appel renvoie 202 Accepted immédiatement avec un enregistrement en file. Le rendu s’exécute en arrière-plan et prend quelques minutes.

202 Accepted 
{
  "id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
  "status": "queued",
  "prompt": "Explain how DNS resolves a domain name",
  "lengthSeconds": 30,
  "voice": "sketchie:sulafat",
  "language": "en",
  "aspect": "16:9",
  "videoUrl": null,
  "sceneGraph": null
}

2. Interrogez le résultat

Récupérez l’explicatif par id jusqu’à ce que son status atteigne un état terminal. Le cycle de vie est queued, puis generating, puis rendering, puis ready (fini) ou failed.

Terminal 
curl https://sketchie.ai/api/v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b \
  -H "Authorization: Bearer sk_..."

Une fois ready, l’enregistrement porte l’URL de la vidéo et le scene graph modifiable :

200 OK 
{
  "id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
  "status": "ready",
  "videoUrl": "https://sketchie.ai/media/....mp4",
  "sceneGraph": { "scenes": [ ... ] }
}

Noms de champs conviviaux et classiques. input et length sont les champs de requête conviviaux. Les anciens prompt (chaîne) et lengthSeconds (un nombre, un multiple positif de 30) sont toujours acceptés comme alias, donc les intégrations existantes continuent de fonctionner. Quand les deux sont envoyés, le champ convivial l’emporte.

Où aller ensuite

  • Référence de l’API . Chaque endpoint, avec les formes de requête et de réponse.
  • Voix . Le narrateur par défaut, le catalogue de six voix et les aperçus jouables.
  • Langues . Les 34 langues de narration prises en charge.
  • CLI et SDK . La ligne de commande sketchie et le client TypeScript @sketchie/sdk.
  • Configuration MCP . Utilisez Sketchie comme outils dans Claude Desktop, Claude Code et l’app Claude.