Inspeccionar Medio
Usa esta acción cuando un workflow necesita conocer la forma de un archivo multimedia — cuánto dura un vídeo o un audio, qué tamaño tiene una imagen y en qué formato está — antes de decidir qué hacer con él.
Ideal para
- Comprobar cuánto dura un vídeo o una grabación antes de convertirlo o transcribirlo
- Asegurarte de que una imagen subida es lo bastante grande antes de usarla como logotipo o foto de perfil
- Comprobar si un vídeo realmente contiene sonido antes de intentar usar su audio
- Estimar cuánto costará una transcripción antes de iniciarla
Por qué importa
Todas las demás formas de mirar un archivo indican su tamaño en bytes y su tipo — y nada más. Eso basta para saber que un archivo es un vídeo de 4 MB, pero no para saber si dura cuatro segundos o cuarenta minutos, y cada caso lleva a decisiones muy distintas.
Esta acción es el único lugar que responde a esas preguntas. Colócala antes del paso que actúa sobre el archivo y usa sus respuestas en la condición de ese paso.
Campos principales
| Campo | Qué hace |
|---|---|
| Archivo | El archivo a inspeccionar, normalmente step(0).file de un paso de subida, descarga o generación de documento |
| Bucket y Ruta completa | Una alternativa al campo Archivo, cuando quieres apuntar directamente al archivo |
| Propósito | Etiqueta opcional que describe el paso en los registros. No cambia qué archivo se inspecciona |
Qué pueden usar los pasos siguientes
| Valor | Qué es |
|---|---|
step(N).durationSeconds | Cuánto dura el vídeo o el audio, en segundos. 0 para imágenes |
step(N).width, step(N).height | Tamaño en píxeles, para vídeos e imágenes. Vacío para archivos solo de audio |
step(N).hasAudio | Si el archivo contiene una pista de sonido |
step(N).formatName | El formato del contenedor, tal como lo identifican las herramientas multimedia |
step(N).videoCodec, step(N).audioCodec | Cómo están codificados la imagen y el sonido |
step(N).sizeBytes, step(N).contentType | Tamaño en bytes y tipo de archivo |
step(N).cached | Si la respuesta ya se conocía — mira más abajo |
Cuánto cuesta
Leer estos detalles implica leer el propio archivo, así que este paso se cobra de tu cuota de transcodificación según lo que tarde. Los archivos más grandes cuestan más; el tamaño del archivo pesa más que su duración. Un pódcast largo en un formato compacto es barato; un clip corto en un formato de altísima calidad no lo es.
Dos cosas lo mantienen bajo control:
- Los archivos de más de 512 MiB se rechazan en lugar de inspeccionarse, con un error claro que indica el límite.
- Inspeccionar el mismo archivo dos veces es gratis. La primera lectura queda registrada en el propio archivo, así que cualquier paso o workflow que lo inspeccione de nuevo obtiene la respuesta sin coste.
step(N).cachedindica qué ocurrió. Los medios que llegaron por una conversación normalmente ya se han inspeccionado, así que son gratis desde el principio.
Qué archivos funcionan
Los vídeos y audios funcionan en general. Las imágenes funcionan — PNG, JPEG, WebP, GIF y SVG — y devuelven una duración de 0.
Un archivo que no es realmente multimedia normalmente no falla. Si alguien sube un archivo de texto llamado foto.png, este paso suele completarse igualmente. Informa un ancho y un alto vacíos — pero una duración de unos 0,04 segundos, que parece real. Es decir, comprobar que la duración es mayor que cero no detecta un archivo defectuoso. Cuando el archivo venga de un origen que no controlas, comprueba step(N).width y no confíes en que el paso falle.
Consejos
- Encadénala directamente: pon Subir al almacenamiento, Descargar al almacenamiento o un archivo recibido en un paso, esta acción en el siguiente, y tu decisión en el posterior.
- Úsala como protección antes de un trabajo caro: consulta
step(N).durationSecondsantes de iniciar una transcripción y descarta el archivo si dura más de lo que quieres pagar. - Consulta
step(N).hasAudioantes de intentar transcribir un vídeo. Un vídeo mudo no produce nada útil, y descubrirlo pronto evita el intento. - Inspeccionar un archivo nunca altera su contenido. Sí registra en el propio archivo lo que encontró, y eso es lo que hace gratis la segunda lectura.