API FFmpeg
para desenvolvedores.
Execute comandos FFmpeg reais na nuvem. Envie um comando por HTTP, deixe o FFHub cuidar de workers, storage, retries e escala, e receba uma URL para o arquivo processado.
curl -X POST https://api.ffhub.io/v1/tasks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"command": "ffmpeg -i https://example.com/input.mp4 -c:v libx264 -crf 24 output.mp4"
}'
# → { "task_id": "tsk_..." }
# Poll GET /v1/tasks/{task_id}
# → outputs[0].urlFFmpeg local é simples.
Produção é a parte difícil.
O comando raramente é o problema. O que trava times é a operação em volta dele.
Manutenção de workers
Manter binários FFmpeg, codecs, pacotes do sistema, CPU e isolamento sem afetar os servidores da aplicação.
Filas e retries
Jobs de vídeo falham, expiram e precisam de polling. Um ciclo de tarefa claro vale mais que outro shell script.
Storage
Inputs precisam de URLs acessíveis, outputs precisam de links duráveis, e arquivos temporários precisam de limpeza.
Escala em pico
Um upload é simples. Um backlog de vídeos de usuários pede controle de concorrência e workers independentes.
Uma superfície de API,
a sintaxe normal do FFmpeg.
O FFHub mantém a integração pequena: envie um arquivo ou URL, crie a tarefa, acompanhe o status e baixe o resultado.
Informe o input
Use uma URL pública ou faça upload de um arquivo local pela Files API.
Envie o comando
Faça POST do comando FFmpeg para /v1/tasks com bearer token.
Acompanhe progresso
Faça polling do status no backend ou acompanhe as execuções no dashboard.
Use a URL de saída
Tarefas concluídas retornam URLs públicas para armazenar, servir ou passar adiante.
Todos os jobs de mídia
que o produto vive adiando.
Se o FFmpeg consegue expressar, o FFHub foi feito para executar como tarefa assíncrona na nuvem.
Transcodificação de vídeo
Converta MOV, MKV, AVI, WebM ou uploads de usuários para MP4, HLS ou DASH prontos para web.
Pipelines de compressão
Reduza uploads grandes com CRF, presets, escala e codecs sob seu controle.
Geração de thumbnail
Capture frames para feeds UGC, CMS, vídeos de produto ou previews.
Extração de áudio
Extraia MP3, AAC, WAV, FLAC ou Opus para transcrição, podcasts e fluxos de IA.
Legendas e overlays
Grave captions, adicione text watermark, overlay de logo e mantenha controle exato dos filtros.
Processamento em lote
Dispare tarefas por filas, webhooks, cron jobs ou workflows do seu backend.
Use FFmpeg diretamente,
sem operar a máquina toda.
O FFHub fica entre infraestrutura crua e APIs de vídeo só com preset.
| Requisito | FFHub | FFmpeg self-hosted | APIs com preset |
|---|---|---|---|
| Controle do comando | Argumentos FFmpeg reais | Controle total | Geralmente limitado aos presets |
| Infraestrutura | Cloud workers e storage gerenciados | Você opera servidores, filas e limpeza | Gerenciado, mas menos FFmpeg-native |
| Filtros custom | Use filter graphs normais | Use filter graphs normais | Frequentemente limitado ou indisponível |
| Integração | REST task API com polling e URLs de saída | Protocolo próprio de worker | Formato de job específico do provider |
| Melhor uso | Devs que já conhecem FFmpeg | Times com capacidade de operar mídia | Times que só precisam de outputs padrão |
Bom para times API-first,
não é uma camada mágica de presets.
O FFHub fica intencionalmente perto do FFmpeg. Esse é o ponto.
Use FFHub quando
- Você já sabe quais flags FFmpeg precisa.
- Você quer tarefas assíncronas sem operar workers.
- Você precisa de filtros custom, stream mapping ou codecs incomuns.
- Você quer começar pequeno e pagar por processamento, não por capacidade.
Use outra opção quando
- Você precisa de um editor visual ou timeline para consumidor final.
- Você quer um fluxo preset-only sem conhecer FFmpeg.
- Você quer possuir todas as máquinas e tunar infraestrutura em baixo nível.
- Você precisa de CMS de vídeo, player, DRM e analytics completos.
Envie sua primeira tarefa FFmpeg
em poucos minutos.
Use o quickstart para ver o fluxo real de request-response, ou abra o playground para testar um comando antes de integrar no backend.