¿Por qué hay cargos de /meta/read en mi facturación?

Los cargos de /meta/read aparecen en tu facturación mensual porque, de forma predeterminada, Transloadit extrae automáticamente metadatos de los archivos que subes y de los archivos producidos por otros Steps. Esto forma parte habitual del procesamiento de archivos y ayuda a habilitar funciones como el uso de ${file.meta.width}, ${file.meta.duration} y otras variables de metadatos extraídos en tus Assembly Instructions.

¿Cuánto cuestan los cargos de /meta/read?

La extracción estándar de metadatos contabiliza el 1 % del tamaño del archivo como bytes de procesamiento facturables para los archivos subidos y los resultados de cada Step con seguimiento. Para una sola extracción:

• Un archivo de 100 MB generaría cargos de extracción de metadatos por 1 MB
• Un archivo de 1 GB generaría cargos de extracción de metadatos por 10 MB

Los metadatos opcionales más costosos pueden generar cargos adicionales. Consulta el parámetro output_meta en la documentación del Robot para obtener más detalles.

¿Cómo puedo evitar los cargos de /meta/read?

Puedes desactivar la extracción automática de metadatos añadiendo "output_meta": false a cada Step cuyo resultado no necesite metadatos extraídos, incluido tu Step de subida:

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

¿Cuándo debo mantener habilitada la extracción de metadatos?

Muchos Templates de procesamiento requieren la extracción de metadatos. Es importante para:

• permitir que los Robots ignoren los tipos de archivo que no pueden procesar
• usar variables de metadatos extraídos de los archivos en tus Assembly Instructions (como ${file.meta.width} y ${file.meta.duration})
• filtrar archivos según las propiedades de los metadatos
• almacenar etiquetas de metadatos junto con tus archivos
• generar rutas de archivo dinámicas basadas en los metadatos extraídos

Los identificadores y nombres de archivo, como ${file.id} y ${file.name}, están disponibles sin extraer metadatos. Por ejemplo, este Template usa el nombre del archivo subido sin extraer metadatos:

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

¿Cuándo puedo desactivar la extracción de metadatos de forma segura?

Puedes desactivar la extracción de metadatos cuando:

• No usas variables file.meta.* extraídas en Steps posteriores
• Tus rutas y nombres usan valores fijos, campos proporcionados o identificadores y nombres de archivo
• No necesitas filtrar ni ordenar archivos según los metadatos extraídos

Ejemplo para un solo archivo subido que no necesita metadatos (fields se proporciona al crear la Assembly):

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