LumeClip

API y MCP de LumeClip para desarrolladores

LumeClip convierte un video largo de YouTube en clips cortos verticales (9:16) con subtítulos. Puedes usarlo desde código, con la API REST, o desde un agente de IA, con el servidor MCP alojado. Ambos usan la misma cuenta y el mismo saldo de minutos.

Autenticación

Crea tu API key en Panel → Perfil → API Key (también en el plan gratuito) y envíala como Authorization: Bearer TU_CLAVE a https://api.lumeclip.com. Mantenla en secreto: tiene acceso total a tu cuenta. Los conectores MCP remotos, como el de claude.ai, inician sesión con OAuth 2.1, sin clave que copiar.

Endpoints

Crea un proyecto, consúltalo hasta que el estado sea DONE y luego obtén y descarga cada clip. El procesamiento reserva minutos del saldo al crear el proyecto. La descripción completa, legible por máquina, está en la especificación OpenAPI.

POST /api/projects

Crea un proyecto a partir de un video público de YouTube

curl -X POST https://api.lumeclip.com/api/projects \
  -H "Authorization: Bearer $LUMECLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sourceType":"YOUTUBE","sourceUrl":"https://www.youtube.com/watch?v=VIDEO_ID"}'

GET /api/projects/{projectId}

Estado del proyecto y sus clips

curl https://api.lumeclip.com/api/projects/PROJECT_ID \
  -H "Authorization: Bearer $LUMECLIP_API_KEY"

GET /api/clips/{clipId}

Un clip, con el token de su página pública para compartir

curl https://api.lumeclip.com/api/clips/CLIP_ID \
  -H "Authorization: Bearer $LUMECLIP_API_KEY"

GET /api/clips/{clipId}/download

Descarga el clip en MP4

curl -L -o clip.mp4 https://api.lumeclip.com/api/clips/CLIP_ID/download \
  -H "Authorization: Bearer $LUMECLIP_API_KEY"

Servidor MCP

El servidor MCP alojado está en https://api.lumeclip.com/mcp (Streamable HTTP). Herramientas: create_project, get_project_status, list_clips y get_clip_url. En Claude Code, Cursor o VS Code, envía la API key en la cabecera Authorization. En claude.ai, agrega un conector personalizado con la misma URL e inicia sesión.

{
  "mcpServers": {
    "lumeclip": {
      "type": "http",
      "url": "https://api.lumeclip.com/mcp",
      "headers": { "Authorization": "Bearer lc_your_key" }
    }
  }
}

Scopes de OAuth

lumeclip:read permite al agente ver tus proyectos y clips. lumeclip:create le permite crear proyectos, lo que gasta minutos. offline_access mantiene la conexión. Tú eliges en la pantalla de consentimiento y puedes desconectarlo cuando quieras en Perfil → Apps conectadas. El token OAuth solo vale en el servidor MCP.

Límites

MCP: 120 llamadas por minuto por cuenta. REST: 100 solicitudes por minuto por IP y 20 proyectos nuevos por hora. Cada respuesta incluye RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset; un 429 incluye también Retry-After, en segundos. Los errores llegan como JSON con error (mensaje) y, cuando existe, code (estable, para que tu código decida). Cada video procesado usa minutos de tu plan.

Versión y cambios

Esta es la versión 1 de la API. Pueden añadirse campos y parámetros opcionales en cualquier momento. Un cambio incompatible se anuncia con al menos 30 días de antelación en esta página, y las operaciones afectadas responden con las cabeceras Deprecation y Sunset durante ese periodo.

Archivos legibles por máquina