API documentation
Getting started
The DeepManim API lets you generate animated explainer videos from your own code. Create videos from text prompts, improve them step by step, and add narration, all through a simple REST API.
https://api.deepmanim.com/api/v1- Audio on generationA new video from /generate includes narration by default.
- No audio on changesResults from /improve have no audio. Finish your changes, then call /audio.
- Estimated timesA video takes about 6 minutes. estimated_time_remaining_seconds counts down live.
Authentication
Every request needs an API key. Create one in Settings, API keys. Send it in the Authorization header:
Authorization: Bearer dm_k_your_api_key_here
Needs a credit purchase. API access opens once you have bought credits at least once. Free credits alone are not enough.
Keep your key secret. Never put it in a public repository or in code that runs in a browser.
Quick start
Generate a video in three steps: create a job, poll until it finishes, then read the result.
1. Generate a video
curl -X POST https://api.deepmanim.com/api/v1/generate \
-H "Authorization: Bearer dm_k_your_key" \
-H "Content-Type: application/json" \
-d '{"message": "Explain how photosynthesis works", "preferred_locale": "en"}'2. Poll for completion
curl https://api.deepmanim.com/api/v1/jobs/JOB_ID \ -H "Authorization: Bearer dm_k_your_key" # Response includes: # 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. Get the result
# When status is "completed", the response includes:
{
"job_id": "...",
"status": "completed",
"phase": "done",
"estimated_time_remaining_seconds": 0,
"result": {
"video_url": "https://...",
"description": "An animation explaining photosynthesis...",
"session_id": "...",
"message_id": "...",
"duration_seconds": 24.6,
"has_audio": true,
"follow_up": "How does cellular respiration relate to photosynthesis?"
}
}Endpoints
Video generation
Jobs
Sessions
Messages
Account
Credits and pricing
Each call that creates a job takes credits from your balance.
Generate and improve costs depend on the quality you pick and range from 1.5 to 70 credits. Reading sessions, messages, jobs and account details is free.
Error responses
Questions? Write to support@deepmanim.com