Documentation de l’API

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.

• 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. Incluez votre clé dans l’en-tête Authorization :

Authorization: Bearer dm_k_your_api_key_here

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.

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

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

# 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

Crédits et tarifs

Chaque appel API qui crée un job déduit des crédits de votre solde :

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

API DeepManim v1 — Une question ? Écrivez à support@deepmanim.com