Por que há cobranças de /meta/read no meu faturamento?

As cobranças de /meta/read aparecem no seu faturamento mensal porque, por padrão, a Transloadit extrai automaticamente metadados dos seus arquivos enviados por upload e dos arquivos produzidos por outros Steps. Isso faz parte do processamento padrão de arquivos e ajuda a viabilizar recursos como o uso de ${file.meta.width}, ${file.meta.duration} e outras variáveis de metadados extraídos nas suas Assembly Instructions.

Qual é o valor das cobranças de /meta/read?

A extração padrão de metadados contabiliza 1% do tamanho do arquivo como bytes de processamento faturáveis para os arquivos enviados por upload e as saídas de cada Step monitorado. Para uma única extração:

• Um arquivo de 100 MB geraria uma cobrança de 1 MB pela extração de metadados
• Um arquivo de 1 GB geraria uma cobrança de 10 MB pela extração de metadados

Metadados opcionais mais caros podem gerar cobranças adicionais. Consulte o parâmetro output_meta na documentação do Robot para saber mais.

Como posso evitar as cobranças de /meta/read?

Você pode desativar a extração automática de metadados adicionando "output_meta": false a cada Step cuja saída não precise de metadados extraídos, incluindo seu Step de upload:

{
  "steps": {
    ":original": {
      "robot": "/upload/handle",
      "output_meta": false
    },
    "resize": {
      "use": ":original",
      "robot": "/image/resize",
      "format": "jpg",
      "width": 200,
      "height": 200,
      "output_meta": false
    }
  }
}

Quando devo manter a extração de metadados ativada?

Muitos Templates de processamento exigem a extração de metadados. Ela é importante para:

• permitir que os Robots ignorem tipos de arquivo que não conseguem processar
• usar variáveis de metadados extraídos dos arquivos nas suas Assembly Instructions (como ${file.meta.width} e ${file.meta.duration})
• filtrar arquivos com base em propriedades dos metadados
• armazenar tags de metadados com seus arquivos
• gerar caminhos de arquivo dinâmicos com base nos metadados extraídos

Identificadores e nomes de arquivos, como ${file.id} e ${file.name}, estão disponíveis sem extração de metadados. Por exemplo, este Template usa o nome do arquivo enviado por upload sem extrair metadados:

{
  "steps": {
    ":original": {
      "robot": "/upload/handle",
      "output_meta": false
    },
    "stored": {
      "use": ":original",
      "robot": "/s3/store",
      "path": "/uploads/${file.id}_${file.name}",
      "output_meta": false
    }
  }
}

Quando posso desativar a extração de metadados com segurança?

Você pode desativar a extração de metadados quando:

• Você não usa variáveis file.meta.* extraídas nos Steps seguintes
• Seus caminhos e nomes usam valores fixos, campos fornecidos ou identificadores e nomes de arquivos
• Você não precisa filtrar ou ordenar arquivos com base nos metadados extraídos

Exemplo para um único arquivo enviado por upload que não precisa de metadados (fields é fornecido na criação da Assembly):

{
  "steps": {
    "uploaded": {
      "robot": "/upload/handle",
      "output_meta": false
    },
    "exported": {
      "use": "uploaded",
      "robot": "/s3/store",
      "path": "${fields.output_path}",
      "output_meta": false
    }
  }
}