O que é o FFHub?

O FFHub é um serviço de API FFmpeg baseado em nuvem que permite executar comandos FFmpeg por meio de chamadas simples de API REST. Sem configuração de servidor, sem dependências — basta enviar seu comando e obter os resultados.

Início Rápido

1. Obtenha Sua Chave de API

Cadastre-se em ffhub.io e crie uma chave de API no painel.

2. Crie uma Tarefa

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 -preset fast output.mp4"
  }'

Resposta:

{
  "task_id": "task_abc123",
  "status": "pending",
  "created_at": "2024-01-01T00:00:00Z"
}

3. Consulte o Status da Tarefa

curl https://api.ffhub.io/v1/tasks/task_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Resposta:

{
  "task_id": "task_abc123",
  "status": "completed",
  "created_at": "2024-01-01T00:00:00Z",
  "finished_at": "2024-01-01T00:03:35Z",
  "elapsed": "215.30",
  "total_elapsed": "220.50",
  "progress": 100,
  "outputs": [
    {
      "filename": "output.mp4",
      "url": "https://storage.ffhub.io/outputs/task_abc123/output.mp4",
      "size": 10485760
    }
  ]
}

Referência da API

URL Base

https://api.ffhub.io/v1

Autenticação

Todas as requisições da API exigem um token Bearer no cabeçalho Authorization:

Authorization: Bearer YOUR_API_KEY

Endpoints

Método	Endpoint	Descrição
POST	/tasks	Criar uma nova tarefa FFmpeg
GET	/tasks/:id	Obter status e resultado da tarefa

Status da Tarefa

Status	Descrição
pending	A tarefa está na fila para processamento
running	A tarefa está sendo processada
completed	A tarefa foi concluída com sucesso
failed	A tarefa falhou com um erro

Preços

1 crédito = 5 segundos de tempo de processamento
$1 = 1.000 créditos

Pague apenas pelo tempo real de processamento, cobrado por segundo.

Suporte

GitHub: ffhub-io/ffmpeg-cookbook (Issues & Discussions)
Email: [email protected]
Twitter: @ffhub_io

Mais Recursos

Para documentação detalhada da API, consulte a Referência da API.

Introdução