ƒƒffhub.io

Introducción a FFHub — FFmpeg en la nube como REST API

FFHub convierte FFmpeg en una REST API. Envía un comando y obtén la URL del archivo de salida.

FFHub convierte FFmpeg en una REST API. Tú envías un comando ffmpeg normal, nosotros lo ejecutamos en workers administrados en la nube, y recibes de vuelta una URL al archivo de salida. Sin servidores que configurar, sin códecs que instalar, sin operaciones.

Úsalo con IA (la forma más rápida)

La manera más rápida de integrar FFHub es pasarle la documentación a un LLM y dejar que escriba el código cliente por ti. Pega el prompt de abajo en ChatGPT, Claude.ai, Gemini o tu asistente de IDE (Cursor / Claude Code / etc.). Ya hace referencia a nuestro llms.txt para que el modelo tenga el contexto correcto.

I want to integrate the FFHub video processing API into my project.

Context for you:
- Project overview: https://www.ffhub.io/llms.txt
- API spec: https://api.ffhub.io/openapi.json

What I want to do: <describe your task — e.g. "convert MP4 to MP3 at 192kbps", "extract a thumbnail at 5 seconds", "compress a video to under 10 MB">
Language / runtime: <Node.js / Python / Go / Bash / ...>

Please write a complete, runnable script that:
1. If I have a local file: POST /v1/uploads/sign to get a presigned URL, then PUT the file directly to that URL. Use the returned public_url as the FFmpeg input.
2. POST /v1/tasks with a `command` field containing the FFmpeg arguments and the input URL.
3. Poll the task by GET /v1/tasks/{id} until status is succeeded or failed, then download from outputs[0].url.
Read my API key from the FFHUB_API_KEY environment variable.

Pruébalo en Postman

Un workspace público de Postman es la forma más rápida de hacer una prueba inicial:

Especificación OpenAPI

La especificación completa en formato legible por máquinas está en api.ffhub.io/openapi.json — incluye gestión de tareas, información de cuenta y el endpoint de firma de carga. Pega la URL en Postman, Bruno o Insomnia, o pásala a openapi-generator / openapi-typescript para generar un cliente con tipos en cualquier lenguaje.

Todos los endpoints requieren un access token Bearer creado en /dashboard/api-keys. GET /v1/tasks/{id} actualmente se puede llamar sin token por compatibilidad con versiones anteriores del ffhub-cli — planeamos requerir autenticación en una versión futura.

Qué puedes hacer

  • Transcodificar y convertir: cualquier formato a cualquier formato, MP4 / WebM / HLS / GIF, cambio de códec
  • Comprimir y redimensionar: reducir archivos, cambiar bitrate o resolución
  • Editar: recortar, combinar, recortar área, rotar, agregar marcas de agua o subtítulos
  • Extraer: audio, fotogramas, miniaturas, metadatos
  • Cualquier otra cosa que ffmpeg pueda hacer — simplemente ejecutamos tu comando

Cómo funciona la facturación

  • 1 crédito = 5 segundos de tiempo de procesamiento, facturado por segundo
  • $1 ≈ 1.000 créditos
  • Créditos gratuitos al registrarse, sin suscripción, los créditos nunca vencen

Solo pagas por el tiempo de procesamiento real, no por el tiempo en la cola.

Explora la documentación

Elige el camino que se adapte a cómo planeas usar FFHub:

Primeros pasos — léelos en orden si nunca has usado FFHub.

  • Inicio rápido — envía tu primera tarea en 3 minutos (curl + Node.js + Python).
  • Subir archivos — convierte un archivo local en una URL que la API pueda leer (multipart, base64 o URL remota).

Ejemplos de código — cuando quieres copiar y pegar código funcional.

Integraciones — cuando no quieres escribir código HTTP en absoluto.

  • CLI tool — npm install -g ffhub, ejecuta tareas desde tu terminal, los archivos locales se suben automáticamente.
  • Nodo comunitario de n8n — agrega FFHub a los flujos de trabajo visuales de n8n.
  • Skill de Claude Code — usa FFHub desde Claude Code como caja de herramientas de FFmpeg.

Si quieres una visión general antes de explorar los endpoints, la guía de la API de FFmpeg explica para qué sirve la API, cómo se compara con ejecutar FFmpeg tú mismo y para qué casos de uso está diseñada.

Soporte

Introducción a FFHub — FFmpeg en la nube como REST API — FFHub Docs