Primeros pasos
La API de DeepManim permite generar vídeos educativos animados mediante programación. Crea vídeos desde prompts de texto, mejóralos de forma iterativa y añade narración, todo con una API REST sencilla.
URL base: https://api.deepmanim.com/api/v1
Notas importantes
- Audio al generar: Al generar un vídeo nuevo mediante /generate, la narración de audio se incluye de forma predeterminada.
- Sin audio en las modificaciones: Al mejorar un vídeo mediante /improve, el resultado no incluye audio. Termina primero todas las modificaciones y añade el audio mediante /audio cuando estés satisfecho con el vídeo.
- Tiempos estimados: La generación de vídeo tarda aproximadamente 6 minutos. El campo estimated_time_remaining_seconds de la respuesta del trabajo ofrece una cuenta atrás en directo.
Autenticación
Todas las solicitudes de la API requieren una clave API. Crea una en Ajustes → Claves API dentro de la aplicación.
Se requiere comprar créditos. El acceso a la API está disponible para usuarios que hayan comprado créditos al menos una vez. Los créditos gratuitos por sí solos no son suficientes.
Incluye tu clave en la cabecera Authorization:
Authorization: Bearer dm_k_your_api_key_here
Mantén tu clave API en secreto. No la compartas en repositorios públicos ni en aplicaciones del lado del cliente.
Inicio rápido
Genera un vídeo en tres pasos: crea un trabajo, consulta hasta que termine y recupera el resultado.
1. Generar un vídeo
curl -X POST https://api.deepmanim.com/api/v1/generate \
-H "Authorization: Bearer dm_k_your_key" \
-H "Content-Type: application/json" \
-d '{"message": "Explica cómo funciona la fotosíntesis", "preferred_locale": "es"}'2. Consultar hasta que termine
curl https://api.deepmanim.com/api/v1/jobs/JOB_ID \ -H "Authorization: Bearer dm_k_your_key" # La respuesta incluye: # 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. Obtener el resultado
# Cuando el estado es "completed", la respuesta incluye:
{
"job_id": "...",
"status": "completed",
"phase": "done",
"estimated_time_remaining_seconds": 0,
"result": {
"video_url": "https://...",
"description": "Una animación que explica la fotosíntesis...",
"session_id": "...",
"message_id": "...",
"duration_seconds": 24.6,
"has_audio": true,
"follow_up": "¿Cómo se relaciona la respiración celular con la fotosíntesis?"
}
}Endpoints
Generación de vídeo
Trabajos
Sesiones
Mensajes
Cuenta
Créditos y precios
Cada llamada a la API que crea un trabajo descuenta créditos de tu saldo:
| Operación | Coste |
|---|---|
| Generar vídeo | Desde 1,5 créditos |
| Mejorar vídeo | Desde 1,5 créditos |
| Añadir audio | 1 crédito |
| Mejorar narración | 1 crédito |
El coste de generar y mejorar depende del preset seleccionado y actualmente va de 1,5 a 70 créditos. Leer sesiones, mensajes, estados de trabajos e información de la cuenta es gratis y no descuenta créditos.
Respuestas de error
| Estado | Significado |
|---|---|
| 401 | Falta la clave API o no es válida |
| 402 | Créditos insuficientes |
| 404 | No se encontró el recurso (sesión, mensaje o trabajo) |
| 400 | Solicitud no válida (por ejemplo, no hay vídeo que mejorar ni narración que perfeccionar) |