Documentación de la API de DeepManim

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 basehttps://api.deepmanim.com/api/v1

Audio al generarAl generar un vídeo nuevo mediante /generate, la narración de audio se incluye de forma predeterminada.
Sin audio en las modificacionesAl 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 estimadosLa 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. Incluye tu clave en la cabecera Authorization:

Authorization: Bearer dm_k_your_api_key_here

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.

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)

API de DeepManim v1 — ¿Preguntas? Escríbenos a support@deepmanim.com