Bien démarrer
L’API DeepManim permet de générer des vidéos d’animation pédagogiques par programmation. Créez des vidéos à partir de prompts, améliorez-les progressivement et ajoutez une narration, le tout avec une API REST simple.
URL de base : https://api.deepmanim.com/api/v1
Notes importantes
- Audio à la génération : Lorsque vous générez une nouvelle vidéo via /generate, la narration audio est incluse par défaut.
- Pas d’audio lors des modifications : Une vidéo améliorée via /improve ne contient pas d’audio. Terminez toutes vos modifications, puis ajoutez l’audio via /audio lorsque la vidéo vous convient.
- Durées estimées : La génération d’une vidéo prend environ 6 minutes. Le champ estimated_time_remaining_seconds de la réponse du job fournit un compte à rebours en direct.
Authentification
Toutes les requêtes API nécessitent une clé API. Créez-en une dans Paramètres → Clés API de l’application.
Un achat de crédits est requis. L’accès à l’API est disponible pour les utilisateurs ayant acheté des crédits au moins une fois. Les crédits gratuits seuls ne suffisent pas.
Incluez votre clé dans l’en-tête Authorization :
Authorization: Bearer dm_k_your_api_key_here
Gardez votre clé API secrète. Ne la partagez pas dans des dépôts publics ou des applications côté client.
Démarrage rapide
Générez une vidéo en trois étapes : créez un job, vérifiez sa fin, puis récupérez le résultat.
1. Générer une vidéo
curl -X POST https://api.deepmanim.com/api/v1/generate \
-H "Authorization: Bearer dm_k_your_key" \
-H "Content-Type: application/json" \
-d '{"message": "Expliquez le fonctionnement de la photosynthèse", "preferred_locale": "fr"}'2. Vérifier l’avancement
curl https://api.deepmanim.com/api/v1/jobs/JOB_ID \ -H "Authorization: Bearer dm_k_your_key" # La réponse contient: # status: "pending" | "running" | "completed" | "failed" # phase: "exploring_ideas" | "brainstorming" | "crafting_vision" | "refining_details" | "assembling_pieces" | "polishing" | "adding_voice" | "iterating" | "done" # estimated_time_remaining_seconds: 285
3. Récupérer le résultat
# Lorsque le statut vaut "completed", la réponse contient:
{
"job_id": "...",
"status": "completed",
"phase": "done",
"estimated_time_remaining_seconds": 0,
"result": {
"video_url": "https://...",
"description": "Une animation qui explique la photosynthèse...",
"session_id": "...",
"message_id": "...",
"duration_seconds": 24.6,
"has_audio": true,
"follow_up": "Quel est le lien entre respiration cellulaire et photosynthèse ?"
}
}Points d’accès
Génération vidéo
Jobs
Sessions
Messages
Compte
Crédits et tarifs
Chaque appel API qui crée un job déduit des crédits de votre solde :
| Opération | Coût |
|---|---|
| Générer une vidéo | À partir de 1,5 crédit |
| Améliorer une vidéo | À partir de 1,5 crédit |
| Ajouter de l’audio | 1 crédit |
| Améliorer la narration | 1 crédit |
Le coût de la génération et de l’amélioration dépend du preset choisi et varie actuellement de 1,5 à 70 crédits. La lecture des sessions, messages, états des jobs et informations du compte est gratuite et ne déduit aucun crédit.
Réponses d’erreur
| Statut | Signification |
|---|---|
| 401 | Clé API manquante ou invalide |
| 402 | Crédits insuffisants |
| 404 | Ressource introuvable (session, message ou job) |
| 400 | Requête invalide (par exemple aucune vidéo à améliorer ou aucune narration à retoucher) |