Resumen e inicio rápido

Sketchie convierte un prompt o un documento en un video explicativo de pizarra y te devuelve tanto el video renderizado como su scene graph editable. Esta es la referencia de la API HTTP, la CLI, el SDK de TypeScript y el servidor MCP.

El acceso a la API está incluido en todos los planes de pago. Crea una clave de API desde Ajustes en la app cuando tengas un plan. Las generaciones por API consumen los minutos de tu plan a la misma tarifa que la app. No hay un precio de API aparte.

Autenticación

Cada petición se autentica con tu clave de API como token Bearer. Crea una clave en la app en Ajustes y luego envíala en la cabecera Authorization:

Cabecera de la petición 
Authorization: Bearer sk_...

La clave se muestra una vez, al crearla. Mantenla en secreto. La URL base de cada endpoint es https://sketchie.ai/api.

Inicio rápido

1. Crea un explicativo

Envía tu tema como input y una duración objetivo opcional como length (una cadena amigable "M:SS" como "0:30" o "1:00", en pasos de 30 segundos). Omite length para duración automática.

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"
  }'

La llamada devuelve 202 Accepted de inmediato con un registro en cola. El renderizado corre en segundo plano y tarda unos minutos.

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. Sondea el resultado

Consulta el explicativo por id hasta que su status llegue a un estado terminal. El ciclo de vida es queued, luego generating, luego rendering, luego ready (listo) o failed.

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

Cuando esté ready, el registro lleva la URL del video y el scene graph editable:

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

Nombres de campo amigables y clásicos. input y length son los campos de petición amigables. Los antiguos prompt (cadena) y lengthSeconds (un número, múltiplo positivo de 30) se siguen aceptando como alias, así que las integraciones existentes siguen funcionando. Cuando se envían ambos, gana el campo amigable.

Adónde ir después

  • Referencia de la API . Cada endpoint, con las formas de petición y respuesta.
  • Voces . El narrador por defecto, el catálogo de seis voces y las vistas previas reproducibles.
  • Idiomas . Los 34 idiomas de narración admitidos.
  • CLI y SDK . La línea de comandos sketchie y el cliente de TypeScript @sketchie/sdk.
  • Configuración de MCP . Usa Sketchie como herramientas en Claude Desktop, Claude Code y la app de Claude.