Error al subir imágenes en Mastodon: límites de tamaño y formato

Intentas subir una foto a Mastodon, pero el servidor la rechaza con un mensaje de error genérico. Las razones más comunes son que el archivo supera el límite de tamaño de la instancia o utiliza un formato de imagen no compatible. Cada servidor de Mastodon establece estas restricciones de forma independiente, por lo que los límites varían mucho entre instancias. Este artículo explica los límites exactos de tamaño de archivo y los formatos aceptados en Mastodon, muestra cómo verificar los límites de tu instancia y proporciona métodos paso a paso para redimensionar o convertir imágenes para que tus subidas tengan éxito.

Por qué Mastodon rechaza una subida de imagen: restricciones de tamaño y formato

Las instancias de Mastodon utilizan dos comprobaciones separadas en el servidor antes de aceptar una imagen subida. La primera comprobación compara el tamaño en bytes del archivo con el valor max_file_size configurado en la instancia. La segunda comprobación verifica la extensión del archivo y el tipo MIME contra una lista blanca de formatos permitidos. Si alguna de las dos comprobaciones falla, el servidor devuelve un error HTTP 422 Entidad no procesable o un mensaje genérico de “Error al subir” en la interfaz web.

El valor predeterminado de max_file_size en el código fuente de Mastodon es de 8 megabytes para imágenes. Los administradores de la instancia pueden cambiar este valor en el archivo de entorno o a través del panel de administración. Muchas instancias populares, como mastodon.social, mantienen el límite de 8 MB. Instancias más pequeñas o especializadas pueden establecer un límite más bajo de 2 MB o 4 MB para ahorrar costos de almacenamiento. Algunas instancias permiten hasta 16 MB o incluso 32 MB para imágenes.

La lista blanca de formatos generalmente incluye JPEG, PNG, GIF y WebP. Mastodon también acepta SVG en algunas instancias, pero muchas lo bloquean por problemas de seguridad. AVIF y BMP no están en la lista blanca predeterminada. Si subes un archivo AVIF, el servidor lo rechazará incluso si el tamaño del archivo está por debajo del límite. El servidor también verifica el contenido real del archivo, no solo la extensión. Renombrar un archivo .png a .jpg no evitará la comprobación.

Cómo verificar los límites de subida de tu instancia

Puedes encontrar los límites exactos de tu instancia sin preguntar al administrador. Abre cualquier cliente de Mastodon e intenta subir una imagen que claramente sea demasiado grande, como un archivo JPEG de 20 MB. El mensaje de error a menudo indica el tamaño máximo permitido. Si tienes acceso al panel de administración, navega a Administración > Configuración del servidor > Subidas. El campo Tamaño máximo de archivo de imagen muestra el límite actual en megabytes. La lista Tipos de imagen permitidos muestra qué extensiones acepta el servidor.

También puedes verificar el endpoint /api/v1/instance de la instancia. Abre un navegador y ve a https://yourinstance.social/api/v1/instance. Busca la clave max_media_attachments dentro del objeto configuration. El valor es el límite de tamaño en bytes. Divide por 1,048,576 para obtener el tamaño en megabytes. El endpoint no lista los formatos permitidos, por lo que debes confiar en el panel de administración o en una subida de prueba para verificar el formato.

Pasos para solucionar una subida de imagen fallida en Mastodon

1. Verifica el tamaño del archivo antes de subirlo
   Haz clic derecho en el archivo de imagen en tu computadora y selecciona Propiedades en Windows u Obtener información en macOS. El tamaño del archivo aparece en el diálogo. Si el tamaño supera los 8 MB, debes reducirlo.
2. Redimensiona la imagen para reducir el tamaño del archivo
   Usa una herramienta gratuita en línea como TinyPNG o Squoosh. Alternativamente, abre la imagen en un editor de imágenes. Reduce la dimensión más larga a 1920 píxeles o menos. Guarda el archivo como JPEG con una calidad del 80 por ciento. Esto generalmente reduce el tamaño del archivo por debajo de 2 MB.
3. Convierte la imagen a un formato compatible
   Si el archivo es AVIF, BMP o TIFF, conviértelo a JPEG o PNG. Usa la misma herramienta en línea o la aplicación Paint integrada en Windows. Abre el archivo en Paint, selecciona Archivo > Guardar como y elige Imagen JPEG. En macOS, abre el archivo en Vista Previa, selecciona Archivo > Exportar y elige JPEG.
4. Renombra el archivo para eliminar caracteres especiales
   El manejador de subidas de Mastodon puede rechazar archivos con caracteres inusuales en el nombre, como corchetes, emojis o espacios. Renombra el archivo usando solo letras, números, guiones y guiones bajos. Por ejemplo, renombra photo (1).jpg a photo-1.jpg.
5. Sube la imagen nuevamente
   Arrastra el archivo modificado al cuadro de redacción de Mastodon. Espera a que el indicador de progreso de subida termine. Si la subida aún falla, el tamaño del archivo sigue siendo demasiado grande o el formato sigue sin ser compatible. Repite los pasos 2 y 3 con una compresión más agresiva.

Errores comunes de subida y cómo solucionarlos

Error “Error al subir” con un archivo de imagen pequeño

Si el archivo tiene menos de 1 MB pero aún falla, es probable que el formato sea el problema. Verifica la extensión del archivo. Algunos editores de imagen guardan archivos con extensión .jfif en lugar de .jpg. Cambia la extensión a .jpg o vuelve a guardar el archivo como JPEG usando el editor. Si el formato es correcto, verifica el nombre del archivo en busca de caracteres especiales como se describe en el paso 4 anterior.

La subida de un GIF animado falla a pesar de estar por debajo del límite de tamaño

Mastodon impone un límite separado de número de fotogramas para GIF animados. El máximo predeterminado es de 100 fotogramas. Si tu GIF tiene más de 100 fotogramas, el servidor lo rechazará incluso si el tamaño del archivo está por debajo de 8 MB. Usa un editor de GIF para reducir el número de fotogramas a 100 o menos. También puedes convertir el GIF a un archivo de video y subirlo como adjunto de video, que tiene un límite de tamaño separado.

La subida funciona en una instancia pero falla en otra

Diferentes instancias tienen diferentes límites. La instancia donde falla la subida probablemente tiene un valor de max_file_size más bajo. Reduce aún más el tamaño del archivo de imagen hasta que cumpla con el límite más estricto. Si subes frecuentemente imágenes grandes, considera mudarte a una instancia con límites más altos o pide a tu administrador que aumente el límite.

Límites de imágenes en Mastodon vs otras plataformas

Elemento	Mastodon (predeterminado)	Twitter / X
Tamaño máximo de archivo de imagen	8 MB	5 MB
Formatos compatibles	JPEG, PNG, GIF, WebP	JPEG, PNG, GIF, WebP
Máximo de fotogramas GIF	100	Sin límite de fotogramas
Límite de dimensiones de imagen	Sin límite estricto (el servidor puede redimensionar)	4096 x 4096 píxeles

El límite de tamaño de imagen predeterminado de Mastodon es más alto que el límite de 5 MB de Twitter, pero el soporte de formatos es casi idéntico. La principal diferencia es la restricción de fotogramas GIF, que no existe en Twitter. Las instancias de Mastodon también pueden configurarse para eliminar automáticamente los metadatos EXIF, lo que reduce el tamaño del archivo sin acción del usuario.

Conclusión

Ahora puedes identificar por qué falló una subida de imagen en Mastodon verificando el tamaño del archivo contra el límite de tu instancia y confirmando el formato. Redimensiona la imagen a menos de 8 MB usando una herramienta como Squoosh o un editor de imágenes, y convierte formatos no compatibles como AVIF a JPEG o PNG. Si encuentras fallos repetidos, verifica el panel de administración en Administración > Configuración del servidor > Subidas para conocer los límites exactos. Para GIF animados, mantén el número de fotogramas en 100 o menos para evitar el rechazo silencioso. Estos pasos resolverán casi todos los errores de subida de imágenes en cualquier instancia de Mastodon.