FlowData

Como baixo os resultados de uma tarefa de mídia?

Publicado em 10. novembro 2026

Quando uma tarefa de mídia termina, os resultados já estão no seu próprio armazenamento ou conosco. Você escolhe isso para cada saída ao criar a tarefa. Veja aqui como obter os arquivos e por quanto tempo eles ficam disponíveis.

Dois caminhos para as saídas

  • URL de upload própria (put_url): o FlowData envia o resultado diretamente ao seu armazenamento, por exemplo ao seu bucket S3. Não há nada para baixar. Na visão da tarefa, a saída mostra URL de upload própria.
  • Armazenada por nós ("managed": true): o FlowData guarda o resultado para você por sete dias. Você o baixa no app ou pela API.

Baixando no app

  1. À esquerda, em Processamento de mídia, abra Tarefas.
  2. Clique no ícone de olho da tarefa desejada.
  3. Role até Saídas. Cada saída marcada como armazenada por nós e com status Enviada tem um ícone de download à direita.
  4. Passe o mouse sobre ele: a dica Baixar (disponível até …) mostra até quando o arquivo fica disponível.
  5. Clique no ícone. O download começa na hora.

As saídas de uma tarefa concluída com o ícone de download e a indicação de até quando o arquivo está disponível

O link por trás do ícone vale somente por cinco minutos e é gerado de novo a cada clique. Por isso, não o copie para outros sistemas: baixe o arquivo ou use a API.

Buscando pela API

Consulte a tarefa pelo ID:

curl "https://api.flowdata.one/v1/media/jobs/SEU_ID_DE_TAREFA" \
  -H "Authorization: Bearer fd_SUA_CHAVE"

Para cada saída armazenada, a resposta contém um download_url e um expires_at. Baixe o arquivo antes desse momento. Enquanto a saída não tiver sido enviada, download_url é null. Se você configurou um webhook, a mesma visão da tarefa vem no retorno job.finished, então não é preciso ficar consultando.

Por quanto tempo os arquivos ficam disponíveis?

  • Saídas armazenadas por nós: sete dias. Depois disso, o ícone de download desaparece.
  • Dados das tarefas, como status, histórico e entregas: 90 dias.
  • Arquivos no seu próprio armazenamento: pelo tempo que você os mantiver lá. O FlowData não exclui nada ali.

Se algo der errado

  • Nenhum ícone de download: a saída foi para a sua própria URL de upload, ainda não está pronta (Pendente), Falhou ou os sete dias já passaram.
  • A saída falhou, mas a tarefa ficou parcialmente pronta: as saídas já enviadas continuam disponíveis. Crie uma nova tarefa para as que faltam. Há informações sobre os códigos de erro em Como acompanho o status das minhas tarefas de mídia?.
  • O arquivo não chega ao seu armazenamento: verifique se a sua put_url tem validade suficiente. Uma tarefa pode ficar esperando um tempo antes de começar. Uma URL expirada aparece como output_url_expired.

Este artigo foi útil?

Voltar para Processamento de mídia