FlowData

Como acompanho o status das minhas tarefas de mídia?

Publicado em 10. novembro 2026

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.

A lista de tarefas de mídia com status, pipeline, data de criação e tempo de processamento

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.

Este artigo foi útil?

Voltar para Processamento de mídia