Cada tarefa de mídia passa por várias etapas em segundo plano. No FlowData, você vê a qualquer momento em que ponto a tarefa está, quais saídas já estão prontas e por que uma tarefa eventualmente falhou. A visão de detalhes se atualiza sozinha enquanto a tarefa está em andamento.
A lista de tarefas
À esquerda, em Processamento de mídia, abra Tarefas. A lista Tarefas de mídia mostra todas as tarefas da sua equipe com Pipeline, Status, momento da criação e Tempo de processamento. O ID da tarefa aparece abaixo da referência.

Para encontrar uma tarefa específica:
- Digite a sua referência ou o ID da tarefa no campo de busca.
- Filtre por Todos os status ou Todos os pipelines.
- Limite o período com Criada a partir de e Criada até.
- Limpar filtros mostra todas as tarefas novamente.
Use o ícone de olho à direita para abrir os detalhes.
Os status em resumo
| Status | Valor na API | Significado |
|---|---|---|
| Na fila | queued |
A tarefa foi aceita e aguarda uma vaga. |
| Baixando | downloading |
O FlowData está buscando o arquivo de entrada. |
| Processando | processing |
O arquivo está sendo convertido. |
| Enviando | uploading |
Os resultados estão sendo enviados ao destino. |
| Concluída | finished |
Todas as saídas foram criadas e enviadas. |
| Falhou | failed |
A tarefa terminou com um erro. |
| Cancelada | cancelled |
A tarefa foi cancelada antes de começar. |
Vídeos de curso e faixas de áudio rodam em uma fila longa própria, então Na fila pode demorar mais ali.
A visão de detalhes
No topo ficam a referência, o status e o ID da tarefa. Abaixo você encontra:
- Visão geral: pipeline, preset da equipe, prioridade, origem, marca d'água, para onde vai o retorno, o Tempo de processamento e os seus metadados
- Entrada: tamanho, tipo de arquivo, dimensões, duração, codec e se há faixa de áudio. O FlowData converte automaticamente vídeos HDR para cores normais (SDR).
- Histórico: quando a tarefa foi criada, iniciada e encerrada
- Saídas: cada saída com status (Pendente, Enviada ou Falhou), tamanho e dimensões
- Entregas de webhook: os retornos para o seu servidor
Entendendo os erros
Uma tarefa com falha mostra no topo uma caixa vermelha Erro com o código do erro, uma explicação, a etapa em que aconteceu e o aviso vale a pena tentar de novo ou tentar de novo não ajuda.
| Código | Significado | O que você pode fazer |
|---|---|---|
input_not_found |
O arquivo de entrada expirou, foi excluído ou está bloqueado. | Gerar um novo link e criar uma nova tarefa. |
input_download_failed |
O arquivo não pôde ser baixado temporariamente. | Tentar de novo. |
input_too_large |
Tamanho, duração ou dimensões acima do limite. | Reduzir o arquivo ou escolher um pipeline para vídeos longos. |
input_unreadable |
O arquivo está danificado ou não é compatível. | Verificar o arquivo ou exportá-lo de novo. |
input_no_video_stream, input_no_audio_stream |
Falta a faixa esperada. | Usar um arquivo ou pipeline adequado. |
processing_failed |
A conversão ou a verificação de qualidade falhou. | Verificar o arquivo e, se preciso, falar com o suporte. |
output_upload_failed |
O resultado não pôde ser enviado à sua URL de upload. | Tentar de novo e verificar o armazenamento. |
output_url_expired |
A sua put_url expirou ou foi recusada. |
Usar uma URL com validade maior. |
timeout |
O tempo máximo de processamento foi excedido. | Tentar de novo; para arquivos muito grandes, escolher um pipeline para vídeos longos. |
insufficient_quota, spend_limit_exceeded |
O saldo, o limite de crédito ou um limite de gastos não foi suficiente para a duração real. | Recarregar o saldo ou ajustar o limite. |
forbidden |
A chave foi desativada durante o processamento. | Usar uma chave válida. |
cancelled |
A tarefa foi cancelada durante o processamento. | Criá-la de novo, se necessário. |
internal_error |
Um erro do nosso lado. | Tentar de novo. |
Não é possível reiniciar uma tarefa com falha. Crie uma nova tarefa, com um novo Idempotency-Key. Com o antigo, em até 24 horas você recebe de volta apenas a tarefa com falha.
As saídas que já foram enviadas continuam disponíveis e são cobradas, mesmo que a tarefa como um todo tenha falhado.
Cancelando uma tarefa
Enquanto uma tarefa não estiver encerrada, você vê Cancelar tarefa no canto superior direito. Uma tarefa em espera termina imediatamente, o saldo reservado é liberado e não há retorno para o seu servidor. Uma tarefa em andamento para em poucos segundos, depois aparece como Falhou com o código cancelled e informa job.failed.
Pela API, isso é feito com DELETE https://api.flowdata.one/v1/media/jobs/{id}. Uma tarefa já encerrada não pode mais ser cancelada, e a API responde com 409 conflict.
Bom saber
- Os dados das tarefas ficam guardados por 90 dias, e as saídas armazenadas por nós por 7 dias. Como baixá-las está em Como baixo os resultados de uma tarefa de mídia?.
- Se uma entrega de webhook falhou, a linha mostra o status HTTP e a Próxima tentativa. Com o ícone de seta Enviar novamente, você dispara a entrega manualmente.