Introducción y guía rápida

1. Obtén una clave de API

En la app, abre Settings → API keys y crea una clave. Las claves tienen la forma chk_live_… y solo se muestran una vez, así que guarda la tuya en un lugar seguro (una variable de entorno es ideal).

• El acceso a la API está incluido en Plus y los planes superiores. Compara los planes.
• Los videos creados con una clave de API, a través de la API, el SDK y la CLI o el servidor MCP que usa una clave, consumen el doble de minutos de tu plan (2x): un video de 1 minuto consume 2 minutos. El conector para Claude y otros asistentes, que inicia sesión en tu cuenta, funciona en todos los planes y cuenta igual que la app.

2. Autentícate

Envía la clave como token Bearer en cada solicitud:

Authorization: Bearer chk_live_...

Todos los cuerpos de solicitud y de respuesta son JSON. La API está en https://app.trychasca.com/api.

3. Crea un video explicativo

Envía lo que quieres explicar en input: un tema, una pregunta o el texto completo de un documento. Elige la duración con length, en tramos de 30 segundos hasta 30:00, u omítela y deja que Chasca decida.

curl -X POST https://app.trychasca.com/api/v1/explainer \
  -H "Authorization: Bearer $CHASCA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Explain how vaccines train the immune system",
    "length": "1:00",
    "aspect": "16:9",
    "preset": "marker"
  }'

La API responde de inmediato con 202 Accepted y el registro en cola. La generación se ejecuta en segundo plano.

{
  "id": "0b9c6f2e-5d1a-4c3e-9a47-2f8e1c7d4b60",
  "status": "queued",
  "stage": null,
  "progress": 0,
  "prompt": "Explain how vaccines train the immune system",
  "lengthSeconds": 60,
  "voice": "chasca:sulafat",
  "language": "en",
  "aspect": "16:9",
  "preset": "marker",
  "videoUrl": null,
  "createdVia": "api",
  "createdAt": "2026-09-23T09:14:02.118Z"
}

4. Espera a que esté listo

Consulta periódicamente el video explicativo (polling) hasta que status sea ready. El estado avanza por queued → generating → rendering → ready (o termina en failed, con un error legible). La mayoría de los videos están listos en menos de un minuto. Si prefieres no hacer polling, suscríbete al flujo de eventos.

curl https://app.trychasca.com/api/v1/explainer/0b9c6f2e-5d1a-4c3e-9a47-2f8e1c7d4b60 \
  -H "Authorization: Bearer $CHASCA_API_KEY"

Un video explicativo listo incluye videoUrl, posterUrl y subtitlesUrl, además del sceneGraph completo y editable, todas las versiones y los tiempos de cada escena. Los enlaces a los archivos multimedia están firmados y expiran después de aproximadamente una semana; vuelve a solicitar el video explicativo para obtener enlaces nuevos.

5. Cambia una sola cosa

Envía un solo cambio, y todo lo demás queda exactamente como estaba. Los subtítulos, el estilo de pizarra, la música, la marca de agua, el logo y la línea de créditos crean una nueva versión gratuita del mismo video, con la misma narración. Una voz o un formato nuevos crean un video aparte a partir del mismo guion y los mismos dibujos, que se cobra como uno nuevo.

curl -X POST https://app.trychasca.com/api/v1/explainer/0b9c6f2e-5d1a-4c3e-9a47-2f8e1c7d4b60/change \
  -H "Authorization: Bearer $CHASCA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "kind": "captions", "captions": true, "captionStyle": "bold" }'

Para cambiar las palabras o los dibujos, envía el sceneGraph del video explicativo con tus cambios a edit: solo se vuelven a dibujar las escenas que cambiaron. Puedes deshacer cualquiera de los dos con revert.

¿Prefieres TypeScript?

El SDK se encarga de todo esto e incluye la espera, los reintentos y las respuestas tipadas. Consulta CLI y SDK. Para que Claude, Cursor u otro agente usen Chasca por ti, consulta Configuración de MCP.

import { ChascaClient } from '@chasca/sdk';

const chasca = new ChascaClient({ apiKey: process.env.CHASCA_API_KEY! });

const job = await chasca.createExplainer({ input: 'How compound interest snowballs', length: '1:00' });
const video = await chasca.waitForExplainer(job.id);
console.log(video.videoUrl);

Límites en resumen

• Solicitudes de generación, de cambio y de edición: 20 por minuto. Todo lo demás: 200 por minuto.
• Duración del video: de 30 segundos a 30 minutos, en tramos de 30 segundos. A partir de los 6 minutos, el video se cuenta en capítulos, y los minutos que te quedan tienen que cubrir la duración que pides.
• Los errores siempre tienen la misma forma: { "error": true, "code": "...", "message": "...", "status": 400 }. Consulta la sección de errores.