Producto9 jul 2026 · 9 min de lectura

API para crear videos faceless desde código o Claude

Crea un video con una sola petición a la API, consulta su progreso y descarga el MP4 terminado. Esta guía cubre el flujo de peticiones, el conector de Claude y tres automatizaciones útiles.

FG
Equipo editorial de FacelessGenie
Equipo de producto · Actualizado 9 jul 2026
Un proceso de creación de videos faceless controlado mediante peticiones a una API

Hacer un video en un panel es sencillo. Hacer treinta deja a la vista cada paso repetitivo: abrir el formulario, pegar el siguiente tema, elegir los mismos ajustes, enviar y volver más tarde a por el archivo. Una API para crear videos existe justo para el momento en que esa repetición se convierte en el trabajo.

Hay dos formas de usarla. Los desarrolladores pueden llamar directamente a la API REST. Quien prefiera una conversación puede conectar Claude y pedir videos con lenguaje natural. Las dos usan los mismos formatos, el mismo saldo de la cuenta y la misma biblioteca de videos terminados que la app principal.

Qué hemos lanzado

  • Una API REST en /api/v1 para crear videos, consultar el progreso, ver el coste en créditos por adelantado, subir recursos y gestionar el trabajo terminado.
  • Un conector MCP para pedir ese mismo trabajo desde Claude, Claude Code, Cursor u otro cliente compatible.
  • Inicio de sesión con tu cuenta para la app de Claude, sin copiar una clave de API personal en el chat.
  • Claves de API personales para integraciones con código, que se crean y revocan desde Ajustes.

Cómo funciona la API

La creación de videos es asíncrona. Haz un POST con un topic y un formatId a /api/v1/videos, y la respuesta devuelve al instante un id de video y el coste en créditos. Usa ese id para consultar el progreso mientras se hace el video. Cuando el estado pasa a COMPLETED, la respuesta incluye la URL del MP4 terminado.

  1. 1POST /api/v1/videos con { topic, formatId }: la respuesta 202 incluye el id del video y creditsCost.
  2. 2GET /api/v1/videos/{id} más o menos cada minuto: el estado pasa por PENDING, PROCESSING y RENDERING.
  3. 3Cuando el estado es COMPLETED, videoUrl es tu video terminado. Descárgalo, publícalo o pásalo al siguiente paso de tu proceso.
Una petición con un tema que pasa por guion, voz, visuales, subtítulos, música y render hasta convertirse en un video vertical terminado
Una petición pone en marcha la cadena de producción; un endpoint de estado te dice cuándo está listo el video.

GET /api/v1/formats devuelve los formatos disponibles y los datos que acepta cada uno. Eso incluye las opciones de duración, los campos propios de cada formato y los huecos de reparto para los videos de personajes. Puedes quedarte con los modelos recomendados por defecto o elegir modelos para el guion, la voz, las imágenes, la animación y la música cuando un proceso necesita más control.

Crear videos desde Claude

El conector MCP es la vía sin código. Añade el conector en Claude, inicia sesión con tu cuenta y describe el video que quieres. Claude puede listar los formatos adecuados, mostrar el coste en créditos, crear el video, consultar su progreso y devolverte el enlace final en la conversación.

“Hazme un short de 60 segundos sobre cinco criaturas de las profundidades que parecen inventadas: música misteriosa, 1080p.”
— Una petición útil incluye el tema, la duración, el ambiente y la calidad de salida.

El conector también puede listar voces, consultar tu saldo, eliminar videos que no quieras y subir referencias de personajes o música. Claude Code y Cursor usan una clave de API personal para esas mismas herramientas.

Tres recetas de automatización

1. El canal de lista de temas

Guarda las ideas de temas aprobadas en una hoja de Google Sheets o una base de datos de Notion. Un flujo programado de n8n o Zapier puede leer la siguiente fila, crear el video, esperar a que termine y dejar el MP4 en una carpeta de revisión. Mantén un paso de aprobación humana antes de publicar; la automatización es buena moviendo trabajo, no decidiendo si un video merece publicarse.

2. La tubería de reutilización

Algunos formatos aceptan una URL de origen. Un script puede vigilar tu propio feed RSS, pasar la URL de un artículo nuevo en formatInputs y crear un borrador de video a partir de él. El mismo patrón sirve para newsletters y novedades de producto que sean tuyas. Revisa el guion antes de publicar, sobre todo cuando la fuente tiene citas, fechas o cifras que pueden necesitar contexto.

3. El productor en Claude

Claude es útil cuando el proceso todavía necesita criterio. Planifica una semana de temas en una sola conversación, compara formatos y costes y luego crea los videos de uno en uno. Puedes revisar cada resultado antes de decidir si el siguiente tema merece el mismo tratamiento.

Tarjetas de temas, un artículo y una conversación que desembocan en una fila de videos verticales terminados
Una lista de temas, un feed de artículos o una conversación pueden alimentar el mismo proceso de video.

Precios y control de la cuenta

El acceso a la API está incluido en todos los planes de pago, sin una suscripción aparte. Los videos usan los mismos precios en créditos que el panel. Antes de crear uno, llama a POST /api/v1/videos/preview-credits con el formato y los ajustes que quieras para ver el coste exacto.

EndpointQué hace
POST /videosCrea un video a partir de un tema: devuelve el id y el coste exacto
GET /videos/{id}Consulta el estado y descarga el MP4 terminado
POST /videos/preview-creditsEl coste exacto antes de crear
GET /formats, /models, /voicesLee las opciones de producción disponibles
POST /assets/presignSube tus propias referencias de personajes y tu música
GET /accountPlan y saldo de créditos actual

Las claves personales se pueden revocar desde Ajustes, y las conexiones de Claude se pueden desconectar desde la cuenta que las aprobó. El registro de créditos muestra los cargos por creación y los reembolsos automáticos de los renders fallidos.

Empieza en 5 minutos

  1. 1Abre Ajustes, entra en API y crea una clave personal. Para Claude, usa el flujo del conector.
  2. 2GET /api/v1/formats para elegir un formato, o empieza con ai-images-short.
  3. 3Haz un POST con tu primer tema a /api/v1/videos y consulta hasta que aparezca COMPLETED.
  4. 4Usa la referencia de endpoints cuando necesites datos opcionales, subidas o un ejemplo de petición para copiar y pegar.

Preguntas frecuentes

No. El acceso a la API está incluido en todos los planes de pago y gasta los mismos créditos que el panel, a los mismos precios. Consulta el coste de cualquier video con POST /videos/preview-credits antes de crearlo.

Empieza ya

Publica hoy tu primer video sin mostrar la cara.

Elige tu nicho y tu estilo, y nosotros armamos el video. De la idea al short terminado en menos de 7 minutos, sin cámara y sin editor.

Sigue leyendo