Um serviço de alta performance escrito em Go para gerar thumbnails de vídeos a partir de URLs. A aplicação é containerizada com Docker, utilizando FFmpeg para o processamento de vídeo, e oferece duas interfaces de uso: uma API REST e uma ferramenta de Linha de Comando (CLI).
- API REST & CLI: Acesse a funcionalidade através de requisições HTTP ou diretamente pelo terminal.
- Processamento em Lote: Gere múltiplas thumbnails de uma só vez, tanto pela API (recebendo um arquivo
.zip) quanto pela CLI. - Controle Granular: Especifique timestamp e proporção (dimensões) para cada vídeo individualmente em uma requisição em lote.
- Eficiência: Utiliza streaming para processar os vídeos diretamente da URL sem a necessidade de baixá-los por completo em disco.
- Containerizado com Docker: Todas as dependências (Go, FFmpeg) estão encapsuladas em um container Docker para um setup e deploy simplificados.
- Configurável: Ajuste parâmetros do servidor e da aplicação através de variáveis de ambiente.
O projeto segue o layout padrão de aplicações Go, separando as responsabilidades em diferentes pacotes.
thumbnail-generator/
├── cmd/
│ ├── api/
│ │ └── main.go
│ └── cli/
│ └── main.go
├── internal/
│ ├── config/
│ │ └── config.go
│ ├── generator/
│ │ └── ffmpeg.go
│ └── server/
│ ├── handler.go
│ └── router.go
├── Dockerfile
├── docker-compose.yml
├── go.mod
└── README.md
-
Clone este repositório para sua máquina local.
-
Navegue até o diretório raiz do projeto pelo terminal.
-
Execute o seguinte comando para construir a imagem Docker e iniciar o container:
docker-compose up --build
O servidor da API estará rodando em http://localhost:8080.
A aplicação pode ser configurada através de variáveis de ambiente no arquivo docker-compose.yml.
| Variável de Ambiente | Descrição | Padrão |
|---|---|---|
PORT |
Porta em que o servidor HTTP irá rodar. | 8080 |
GENERATOR_TIMEOUT_SECONDS |
Timeout em segundos para a operação do FFmpeg. | 30 |
HTTP_READ_TIMEOUT_SECONDS |
Timeout de leitura para requisições HTTP. | 5 |
HTTP_WRITE_TIMEOUT_SECONDS |
Timeout de escrita para respostas HTTP. | 45 |
HTTP_IDLE_TIMEOUT_SECONDS |
Timeout de inatividade para conexões HTTP. | 60 |
- Método:
POST - URL:
http://localhost:8080/api/v1/generate - Resposta de Sucesso: A imagem binária
image/jpeg.
Exemplo com curl:
curl -X POST \
http://localhost:8080/api/v1/generate \
-H "Content-Type: application/json" \
-d '{"url": "[https://test-videos.co.uk/vids/bigbuckbunny/mp4/h264/360/Big_Buck_Bunny_360_10s_1MB.mp4](https://test-videos.co.uk/vids/bigbuckbunny/mp4/h264/360/Big_Buck_Bunny_360_10s_1MB.mp4)", "timestamp": "00:00:05"}' \
-o minha_thumbnail.jpgEste endpoint oferece controle granular sobre cada thumbnail.
- Método:
POST - URL:
http://localhost:8080/api/v1/generate/advanced-batch - Body (JSON):
defaultTimestamp(opcional): Timestamp padrão.defaultProportion(opcional): Proporção padrão (ex:"1280:720").videos: Uma lista de tarefas, onde cada tarefa pode terurl(obrigatório),timestamp(opcional) eproportion(opcional).
- Resposta de Sucesso: Um arquivo
application/zip.
Exemplo de Payload (salve como payload.json):
{
"defaultTimestamp": "00:00:02",
"defaultProportion": "854:480",
"videos": [
{
"url": "[https://test-videos.co.uk/vids/bigbuckbunny/mp4/h264/360/Big_Buck_Bunny_360_10s_1MB.mp4](https://test-videos.co.uk/vids/bigbuckbunny/mp4/h264/360/Big_Buck_Bunny_360_10s_1MB.mp4)",
"timestamp": "00:00:08",
"proportion": "1920:1080"
},
{
"url": "[https://test-videos.co.uk/vids/elephantsdream/mp4/h264/360/Elephants_Dream_360_10s_2MB.mp4](https://test-videos.co.uk/vids/elephantsdream/mp4/h264/360/Elephants_Dream_360_10s_2MB.mp4)",
"timestamp": "00:00:05"
},
{
"url": "[https://sample-videos.com/video123/mp4/720/big_buck_bunny_720p_1mb.mp4](https://sample-videos.com/video123/mp4/720/big_buck_bunny_720p_1mb.mp4)"
}
]
}Exemplo com curl:
curl -X POST \
http://localhost:8080/api/v1/generate/advanced-batch \
-H "Content-Type: application/json" \
--data-binary "@payload.json" \
-o advanced_thumbnails.zip1. Crie uma pasta de saída: mkdir output
2. Execute via docker-compose run:
O comando abaixo gera 2 thumbnails, uma com a proporção padrão e outra com uma específica.
docker-compose run --rm \
-v "$(pwd)/output:/app/output" \
thumbnail-generator \
./cli \
-urls="URL_VIDEO_1.mp4,URL_VIDEO_2.mp4" \
-time="00:00:01" \
-proportion="1280:720" \
-output="/app/output"- Os arquivos
thumbnail_1.jpgethumbnail_2.jpgaparecerão na sua pastaoutput. -v "$(pwd)/output:/app/output"mapeia sua pasta local para a pasta do container.- O caminho em
-outputdeve ser o de dentro do container.