Processamento de mídia
Processe vídeo, áudio e imagens por API
Você indica uma origem e um pipeline, o FlowData gera as saídas e avisa quando estiverem prontas. Cobrança por minuto de saída iniciado, imagens por arquivo.
Somente para empresas e profissionais autônomos
- Vídeo SD 0,008 EUR por minuto de saída iniciado
- Vídeo HD 0,014 EUR por minuto de saída iniciado
- Vídeo 4K 0,03 EUR por minuto de saída iniciado
- Áudio 0,004 EUR por minuto de saída iniciado
- Imagem 0,001 EUR por arquivo de saída
/v1/media/jobs
curl -X POST "https://api.flowdata.one/v1/media/jobs" \
-H "Authorization: Bearer fd_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"pipeline": "ugc_video",
"input": {
"url": "https://files.example.com/in.mov"
},
"outputs": {
"clean": {
"managed": true
}
},
"reference": "order-4711"
}'
{
"id": "01J8Z6Q4T0M3S1V7B2X9K5N4RD",
"status": "queued",
"pipeline": "ugc_video",
"preset": null,
"reference": "order-4711",
"priority": "normal",
"created_at": "2026-11-09T10:00:00Z",
"started_at": null,
"finished_at": null,
"input": {
"size": null,
"duration": null,
"width": null,
"height": null,
"video_codec": null,
"has_audio": null
},
"outputs": {
"clean": {
"status": "pending",
"target": "managed",
"size": null,
"width": null,
"height": null,
"duration": null,
"sha256": null,
"download_url": null,
"expires_at": null
}
},
"options": {},
"error": null,
"processing_seconds": null,
"cancel_requested": false,
"queue_position": 1
}
Campos e estrutura como na API, os valores são exemplos.
Endpoints
POST /v1/media/jobs responde imediatamente com 202 e um ID. Você busca o status com GET /v1/media/jobs/{id} ou recebe por webhook.
| POST | /v1/media/jobs |
Criar um trabalho: pipeline ou preset, origem e saídas. |
|---|---|---|
| GET | /v1/media/jobs/{id} |
Status, progresso e saídas de um trabalho, as saídas prontas com download_url. |
| GET | /v1/media/jobs |
Encontrar trabalhos pela sua referência (?reference=). |
| DELETE | /v1/media/jobs/{id} |
Cancelar um trabalho na fila ou solicitar o cancelamento de um em execução. |
| POST | /v1/media/uploads |
Um endereço assinado para o envio direto de um arquivo de origem. |
| GET | /v1/media/usage |
Contagem de trabalhos e volumes de dados em um período. |
Pipelines
Cada pipeline tem saídas e limites fixos; você cria os seus como presets da equipe.
-
Vídeo
ugc_video,chat_videoevideoaté 2 GB e 10 minutos,course_videoaté 5 GB e 3 horas. -
Imagem
ugc_image,chat_imageeimageredimensionam, cortam e, se quiser, aplicam marca d'água em imagens de até 50 MB. -
Miniaturas e áudio
video_thumbnailgera uma miniatura,audio_extractextrai a faixa de áudio. -
Presets e marcas d'água
Seus próprios presets com
POST /v1/media/presets, marcas d'água como asset da equipe comPUT /v1/media/assets/{key}.
Onde os resultados ficam
-
No FlowData
Com
managed: truea saída fica disponível por 7 dias, e o trabalho traz umdownload_urlassinado. -
Com você
Com
put_urlo FlowData envia a saída diretamente para o seu próprio armazenamento. -
Origem
Um endereço
httpspúblico ou um envio direto assinado comPOST /v1/media/uploads, válido por 24 horas.
Feito para produção
-
Webhooks
Eventos como
job.finishedejob.failedvão para endpoints registrados, assinados segundo o Standard Webhooks e repetidos até 7 vezes. -
Idempotência
Com o cabeçalho
Idempotency-Key, uma repetição dentro de 24 horas não cria um segundo trabalho. -
Reserva de custo
O valor máximo previsto é reservado na criação do trabalho, e só o que foi entregue é cobrado ao final.
Capturas de tela mostram a interface do FlowData em alemão, com os dados de exemplo de uma empresa fictícia.
Limites do processamento
Processamos seus arquivos nos nossos próprios servidores com ffmpeg e ImageMagick e os guardamos no nosso armazenamento de objetos. Eles não vão para serviços externos.
Por chave, até 60 novos trabalhos e 600 outras solicitações por minuto, e no máximo 200 trabalhos na fila por equipe.
Os dados do trabalho ficam guardados por 90 dias, as saídas no FlowData por 7 dias. Depois disso são excluídos.
O FlowData reserva o valor máximo previsto na criação do trabalho. Se o saldo não for suficiente, o trabalho é recusado.
Perguntas frequentes
put_url por saída o FlowData envia diretamente para lá.
GET /v1/media/jobs/{id} ou registre um endpoint de webhook.