Présentation et démarrage rapide

1. Obtenir une clé API

Dans l’application, ouvrez Settings → API keys et créez une clé. Les clés ont la forme chk_live_… et ne s’affichent qu’une seule fois : conservez la vôtre en lieu sûr (une variable d’environnement est idéale).

• L’accès à l’API est inclus à partir de l’offre Plus. Comparer les offres.
• Les vidéos créées avec une clé API, via l’API, le SDK et la CLI ou le serveur MCP qui fonctionne avec une clé, comptent double sur les minutes de votre offre : une vidéo d’une minute en consomme deux. Le connecteur pour Claude et les autres assistants, qui se connecte à votre compte, fonctionne avec toutes les offres, et ses vidéos comptent comme celles de l’application.

2. S’authentifier

Envoyez la clé sous forme de token Bearer dans chaque requête :

Authorization: Bearer chk_live_...

Tous les corps de requête et de réponse sont en JSON. L’API est accessible à l’adresse https://app.trychasca.com/api.

3. Créer une vidéo explicative

Envoyez ce que vous voulez expliquer dans input : un sujet, une question ou le texte intégral d’un document. Choisissez une durée avec length, par paliers de 30 secondes jusqu’à 30:00, ou omettez-la pour laisser Chasca décider.

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

L’API répond immédiatement 202 Accepted avec l’enregistrement en file d’attente. La génération s’effectue en arrière-plan.

{
  "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. Attendre la vidéo

Interrogez régulièrement la vidéo explicative jusqu’à ce que status passe à ready. Le statut suit la séquence queued → generating → rendering → ready (ou failed, avec un message lisible dans error). La plupart des vidéos sont prêtes en moins d’une minute. Si vous préférez éviter le polling, abonnez-vous au flux d’événements.

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

Une vidéo explicative prête contient videoUrl, posterUrl et subtitlesUrl, ainsi que le sceneGraph complet et modifiable, toutes les versions et le minutage de chaque scène. Les liens vers les médias sont signés et expirent au bout d’une semaine environ ; récupérez de nouveau la vidéo explicative pour obtenir des liens à jour.

5. Changer une chose

Envoyez un seul changement : tout le reste demeure exactement tel quel. Les sous-titres, le style du tableau, la musique, le filigrane, le logo et la mention de crédit créent gratuitement une nouvelle version de la même vidéo, avec la même narration. Une nouvelle voix ou un nouveau format crée une vidéo distincte à partir du même script et des mêmes dessins, facturée comme une nouvelle vidéo.

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

Pour changer les mots ou les dessins, renvoyez le sceneGraph de la vidéo explicative avec vos modifications à edit : seules les scènes modifiées sont redessinées. Dans les deux cas, revenez en arrière avec revert.

Vous préférez TypeScript ?

Le SDK encapsule tout cela, y compris l’attente, les nouvelles tentatives et les réponses typées. Consultez la page CLI et SDK. Pour laisser Claude, Cursor ou un autre agent piloter Chasca, consultez la page Configuration 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);

Les limites en bref

• Requêtes de génération, de changement et de modification : 20 par minute. Tout le reste : 200 par minute.
• Durée des vidéos : de 30 secondes à 30 minutes, par paliers de 30 secondes. Au-delà de 6 minutes, la vidéo est racontée en chapitres, et les minutes qu’il vous reste doivent couvrir la durée demandée.
• Les erreurs ont toujours la même forme : { "error": true, "code": "...", "message": "...", "status": 400 }. Voir les erreurs.