Überblick und Schnellstart

1. API-Schlüssel erstellen

Öffne in der App Settings → API keys und erstelle einen Schlüssel. Schlüssel haben die Form chk_live_… und werden nur einmal angezeigt. Bewahre deinen also sicher auf (eine Umgebungsvariable ist ideal).

• API-Zugriff ist ab Plus enthalten. Tarife vergleichen.
• Videos, die mit einem API-Schlüssel entstehen, also über die API, das SDK und die CLI oder den MCP-Server mit Schlüssel, verbrauchen die Minuten deines Tarifs doppelt: Ein einminütiges Video verbraucht 2 Minuten. Der Connector für Claude und andere Assistenten, der sich bei deinem Konto anmeldet, funktioniert in jedem Tarif und zählt wie die App.

2. Authentifizieren

Sende den Schlüssel bei jeder Anfrage als Bearer-Token:

Authorization: Bearer chk_live_...

Anfragen und Antworten verwenden durchgehend JSON. Die API erreichst du unter https://app.trychasca.com/api.

3. Erklärvideo erstellen

Übergib in input, was erklärt werden soll: ein Thema, eine Frage oder den vollständigen Text eines Dokuments. Wähle mit length eine Länge in 30-Sekunden-Schritten bis 30:00, oder lass das Feld weg, dann entscheidet Chasca.

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

Die API antwortet sofort mit 202 Accepted und dem eingereihten Datensatz. Die Generierung läuft im Hintergrund.

{
  "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. Auf das Video warten

Frag das Erklärvideo per Polling ab, bis status den Wert ready hat. Es durchläuft queued → generating → rendering → ready (oder endet mit failed und einem verständlichen error). Die meisten Videos sind in weniger als einer Minute fertig. Wenn du lieber nicht pollen möchtest, abonniere den Event-Stream.

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

Ein fertiges Erklärvideo enthält videoUrl, posterUrl und subtitlesUrl, dazu den vollständigen, bearbeitbaren sceneGraph, alle Versionen und die Zeitangaben jeder Szene. Medienlinks sind signiert und laufen nach etwa einer Woche ab. Ruf das Erklärvideo erneut ab, um neue Links zu erhalten.

5. Eine Sache ändern

Sende eine Änderung, und alles andere bleibt genau so, wie es war. Untertitel, Whiteboard-Stil, Musik, Wasserzeichen, Logo und Credit-Zeile ergeben kostenlos eine neue Version desselben Videos, mit derselben Vertonung. Eine neue Stimme oder ein neues Format ergibt ein eigenes Video aus demselben Skript und denselben Zeichnungen, das wie ein neues berechnet wird.

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

Um die Worte oder die Zeichnungen zu ändern, schickst du den sceneGraph des Erklärvideos mit deinen Änderungen an edit zurück: Nur die geänderten Szenen werden neu gezeichnet. Beides machst du mit revert rückgängig.

Lieber mit TypeScript?

Das SDK nimmt dir all das ab: Es wartet auf das Ergebnis, wiederholt Anfragen bei Bedarf und liefert typisierte Antworten. Mehr dazu unter CLI und SDK. Wenn Claude, Cursor oder ein anderer Agent Chasca steuern soll, sieh dir die MCP-Einrichtung an.

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);

Limits auf einen Blick

• Anfragen zum Generieren, Ändern und Bearbeiten: 20 pro Minute. Alles andere: 200 pro Minute.
• Videolänge: 30 Sekunden bis 30 Minuten, in 30-Sekunden-Schritten. Ist ein Video länger als 6 Minuten, wird es in Kapiteln erzählt, und deine restlichen Minuten müssen für die gewünschte Länge reichen.
• Fehler sehen immer gleich aus: { "error": true, "code": "...", "message": "...", "status": 400 }. Siehe Fehler.