API de Videora — Documentación para Desarrolladores

¿Qué es Videora?

Videora es una API REST para generar videos cortos profesionales a partir de una configuración JSON. Ideal para videos de marketing, reels, tutoriales y contenido social automatizado.

Incluye: narración con voces naturales en español, subtítulos automáticos, música de fondo, logos y formatos 9:16 (TikTok/Reels), 16:9 (YouTube) y 1:1 (Instagram).

Gratis: 3 videos/mes. Pro ($19/mes): 50 videos/mes. Lifetime ($149): 200 videos/mes de por vida.

Autenticación

No se requiere API key para el tier gratuito. El rate limit se aplica por IP.

Para planes Pro/Premium, incluye tu API key:

Authorization: Bearer tu-api-key

Endpoints

Método	Ruta	Descripción
`POST`	/v1/video/render	Encolar generación de video
`GET`	/v1/jobs/{id}	Estado del job (queued/processing/done)
`GET`	/output/{id}.mp4	Descargar video generado
`GET`	/v1/voices	Catálogo de voces TTS
`GET`	/v1/niches	Nichos preconfigurados (paleta+voz+SFX)
`GET`	/v1/features	Capacidades del motor de video
`GET`	/v1/addons	Add-ons opcionales
`GET`	/pricing	Planes y precios (JSON)
`GET`	/stats	Estadísticas públicas

Ejemplos de uso

Generar un video corto

Crea un video vertical (9:16) con narración, subtítulos y música.

curl -X POST https://videora.4l3.org/v1/video/render \
  -H "Content-Type: application/json" \
  -d '{
    "template": "short",
    "format": "9:16",
    "duration_s": 30,
    "narration": {
      "text": "¿Sabías que puedes crear videos con IA? Videora lo hace en segundos.",
      "voice": "es-MX-Ald"
    },
    "background": {"type": "color", "color": "#1e293b"},
    "captions": {"enabled": true, "font": "bold", "position": "bottom"},
    "music": {"volume": 0.3}
  }'

import requests
import time

# 1. Encolar el video
response = requests.post(
    "https://videora.4l3.org/v1/video/render",
    json={
        "template": "short",
        "format": "9:16",
        "duration_s": 30,
        "narration": {
            "text": "¿Sabías que puedes crear videos con IA?",
            "voice": "es-MX-Ald",
        },
        "background": {"type": "color", "color": "#1e293b"},
        "captions": {"enabled": True, "font": "bold"},
    },
)
job = response.json()
print(f"Job: {job['job_id']}")

# 2. Esperar a que termine
while True:
    status = requests.get(
        f"https://videora.4l3.org/v1/jobs/{job['job_id']}"
    ).json()
    if status["status"] == "done":
        break
    time.sleep(5)

# 3. Descargar
mp4 = requests.get(f"https://videora.4l3.org{status['output_url']}")
with open("video.mp4", "wb") as f:
    f.write(mp4.content)
print("Video descargado ✓")

const response = await fetch("https://videora.4l3.org/v1/video/render", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    template: "short",
    format: "9:16",
    duration_s: 30,
    narration: {
      text: "¿Sabías que puedes crear videos con IA?",
      voice: "es-MX-Ald",
    },
    background: { type: "color", color: "#1e293b" },
    captions: { enabled: true, font: "bold" },
  }),
});
const { job_id } = await response.json();
console.log(`Job: ${job_id}`);

Respuesta:

{
  "job_id": "vid_abc123",
  "status": "queued",
  "estimated_seconds": 45
}

Consultar estado del job

Los videos se generan de forma asíncrona. Consulta el estado con el job_id.

curl https://videora.4l3.org/v1/jobs/vid_abc123

import requests

status = requests.get(
    "https://videora.4l3.org/v1/jobs/vid_abc123"
).json()
print(f"Estado: {status['status']}")
if status["status"] == "done":
    print(f"Descargar: {status['output_url']}")

const status = await fetch("https://videora.4l3.org/v1/jobs/vid_abc123")
  .then(r => r.json());
console.log(`Estado: ${status.status}`);

Respuesta:

{
  "job_id": "vid_abc123",
  "status": "done",
  "output_url": "/output/vid_abc123.mp4",
  "duration_s": 30,
  "file_size_mb": 8.2
}

Listar voces disponibles

Consulta las voces TTS disponibles para narración.

curl https://videora.4l3.org/v1/voices

import requests

voices = requests.get("https://videora.4l3.org/v1/voices").json()
for v in voices["voices"]:
    print(f"{v['id']}: {v['name']} ({v['lang']})")

const { voices } = await fetch("https://videora.4l3.org/v1/voices")
  .then(r => r.json());
voices.forEach(v => console.log(`${v.id}: ${v.name}`));

Respuesta:

{
  "voices": [
    {"id": "es-MX-Ald", "name": "Ald", "lang": "es-MX"},
    {"id": "es-ES-Davefx", "name": "Davefx", "lang": "es-ES"}
  ],
  "total": 3
}

Probar la API

Haz llamadas reales a la API directamente desde aqui. Sin API key necesaria para el plan gratuito.

GET /v1/voices Listar voces disponibles

Límites de uso

Free (sin registro): 3 videos/mes por IP. Duración máxima 60 segundos.

Pro ($19/mes): 50 videos/mes. Hasta 180 segundos. Sin marca de agua.

Premium ($49/mes): 200 videos/mes. Prioridad en cola.

Lifetime ($149): Nivel Premium de por vida, pago único.

SDK Python

Instala el SDK oficial y úsalo en 3 líneas:

pip install videora

Ejemplo:

from videora import Videora

client = Videora()  # Free tier, no API key needed

result = client.render(
    template="short",
    narration="5 datos curiosos sobre México.",
    fmt="9:16",
)
client.download(result["output_url"], "video.mp4")

Paquete: videora · Compatible con Python 3.8+

Recursos API

Descarga la especificación para tu herramienta favorita:

OpenAPI 3.1 (JSON) Swagger UI

Compatible con Postman, Insomnia, Swagger, y cualquier cliente OpenAPI.

Empieza gratis

No necesitas API key para empezar. Simplemente haz tu primera llamada:

curl https://videora.4l3.org/api?format=json

Ir a Videora Ver planes

¿Prefieres JSON? Llama este URL con Accept: application/json o agrega ?format=json.