Você tenta enviar uma foto para o Mastodon, mas o servidor a rejeita com uma mensagem de erro genérica. Os motivos mais comuns são o arquivo exceder o limite de tamanho da instância ou usar um formato de imagem não suportado. Cada servidor Mastodon define essas restrições de forma independente, então os limites variam muito entre as instâncias. Este artigo explica os limites exatos de tamanho e os formatos aceitos para o Mastodon, mostra como verificar os limites da sua instância e fornece métodos passo a passo para redimensionar ou converter imagens para que seus uploads sejam bem-sucedidos.
Principais Conclusões: Limites e Correções para Upload de Imagens no Mastodon
- Preferências > Aparência > CSS Personalizado: Não relacionado a uploads, mas o painel de administração em Admin > Configurações do Servidor > Uploads mostra o limite exato de tamanho para sua instância.
- Tamanho máximo do arquivo: O padrão é 8 MB para imagens na maioria das instâncias, mas muitos administradores aumentam ou diminuem esse valor.
- Formatos de imagem aceitos: JPEG, PNG, GIF e WebP são universalmente suportados; AVIF e BMP podem falhar em instâncias mais antigas.
Por que o Mastodon Rejeita um Upload de Imagem: Restrições de Tamanho e Formato
As instâncias do Mastodon realizam duas verificações separadas no servidor antes de aceitar uma imagem enviada. A primeira verificação compara o tamanho do arquivo em bytes com o valor configurado max_file_size da instância. A segunda verificação confirma a extensão do arquivo e o tipo MIME em uma lista de permissões de formatos aceitos. Se alguma das verificações falhar, o servidor retorna um erro HTTP 422 Unprocessable Entity ou uma mensagem genérica “Falha no upload” na interface web.
O valor padrão de max_file_size no código-fonte do Mastodon é de 8 megabytes para imagens. Os administradores da instância podem alterar esse valor no arquivo de ambiente ou através do painel de administração. Muitas instâncias populares, como mastodon.social, mantêm o limite de 8 MB. Instâncias menores ou especializadas podem definir um limite menor, de 2 MB ou 4 MB, para economizar custos de armazenamento. Algumas instâncias permitem até 16 MB ou mesmo 32 MB para imagens.
A lista de permissões de formato normalmente inclui JPEG, PNG, GIF e WebP. O Mastodon também aceita SVG em algumas instâncias, mas muitas o bloqueiam por questões de segurança. AVIF e BMP não estão na lista de permissões padrão. Se você enviar um arquivo AVIF, o servidor o rejeitará mesmo que o tamanho do arquivo esteja dentro do limite. O servidor também verifica o conteúdo real do arquivo, não apenas a extensão. Renomear um arquivo .png para .jpg não contornará a verificação.
Como Verificar os Limites de Upload da Sua Instância
Você pode descobrir os limites exatos da sua instância sem perguntar ao administrador. Abra qualquer cliente Mastodon e tente enviar uma imagem claramente muito grande, como um arquivo JPEG de 20 MB. A mensagem de erro geralmente informa o tamanho máximo permitido. Se você tiver acesso ao painel de administração, navegue até Administração > Configurações do Servidor > Uploads. O campo Tamanho máximo do arquivo de imagem mostra o limite atual em megabytes. A lista Tipos de imagem permitidos mostra quais extensões o servidor aceita.
Você também pode verificar o endpoint /api/v1/instance da instância. Abra um navegador e vá para https://suainstancia.social/api/v1/instance. Procure pela chave max_media_attachments dentro do objeto configuration. O valor é o limite de tamanho em bytes. Divida por 1.048.576 para obter o tamanho em megabytes. O endpoint não lista os formatos permitidos, então você deve confiar no painel de administração ou em um upload de teste para verificar o formato.
Passos para Corrigir uma Falha no Upload de Imagem no Mastodon
- Verifique o tamanho do arquivo antes de enviar
Clique com o botão direito no arquivo de imagem no seu computador e selecione Propriedades no Windows ou Obter Informações no macOS. O tamanho do arquivo aparece na janela. Se o tamanho exceder 8 MB, você precisa reduzi-lo. - Redimensione a imagem para reduzir o tamanho do arquivo
Use uma ferramenta online gratuita como TinyPNG ou Squoosh. Alternativamente, abra a imagem em um editor de imagens. Reduza a dimensão mais longa para 1920 pixels ou menos. Salve o arquivo como JPEG com qualidade de 80%. Isso geralmente reduz o tamanho do arquivo para menos de 2 MB. - Converta a imagem para um formato suportado
Se o arquivo for AVIF, BMP ou TIFF, converta-o para JPEG ou PNG. Use a mesma ferramenta online ou o aplicativo Paint integrado no Windows. Abra o arquivo no Paint, selecione Arquivo > Salvar como e escolha Imagem JPEG. No macOS, abra o arquivo no Preview, selecione Arquivo > Exportar e escolha JPEG. - Renomeie o arquivo para remover caracteres especiais
O manipulador de upload do Mastodon pode rejeitar arquivos com caracteres incomuns no nome, como colchetes, emojis ou espaços. Renomeie o arquivo usando apenas letras, números, hífens e underscores. Por exemplo, renomeiefoto (1).jpgparafoto-1.jpg. - Envie a imagem novamente
Arraste o arquivo modificado para a caixa de composição do Mastodon. Aguarde o indicador de progresso do upload terminar. Se o upload ainda falhar, o tamanho do arquivo ainda está muito grande ou o formato ainda não é suportado. Repita os passos 2 e 3 com compressão mais agressiva.
Falhas Comuns de Upload e Como Resolvê-las
Erro “Falha no upload” com um arquivo de imagem pequeno
Se o arquivo tem menos de 1 MB mas ainda falha, provavelmente o formato é o problema. Verifique a extensão do arquivo. Alguns editores de imagem salvam arquivos com extensão .jfif em vez de .jpg. Renomeie a extensão para .jpg ou salve novamente o arquivo como JPEG usando o editor. Se o formato estiver correto, verifique o nome do arquivo em busca de caracteres especiais, conforme descrito no passo 4 acima.
Upload de GIF animado falha apesar de estar abaixo do limite de tamanho
O Mastodon impõe um limite separado de contagem de quadros para GIFs animados. O máximo padrão é 100 quadros. Se o seu GIF tiver mais de 100 quadros, o servidor o rejeitará mesmo que o tamanho do arquivo esteja abaixo de 8 MB. Use um editor de GIF para reduzir a contagem de quadros para 100 ou menos. Você também pode converter o GIF em um arquivo de vídeo e enviá-lo como anexo de vídeo, que tem um limite de tamanho separado.
Upload funciona em uma instância, mas falha em outra
Instâncias diferentes têm limites diferentes. A instância onde o upload falha provavelmente tem um valor de max_file_size menor. Reduza ainda mais o tamanho do arquivo de imagem até que ele atenda ao limite mais restrito. Se você envia imagens grandes com frequência, considere migrar para uma instância com limites maiores ou peça ao seu administrador para aumentar o limite.
Limites de Imagem do Mastodon vs. Outras Plataformas
| Item | Mastodon (padrão) | Twitter / X |
|---|---|---|
| Tamanho máximo do arquivo de imagem | 8 MB | 5 MB |
| Formatos suportados | JPEG, PNG, GIF, WebP | JPEG, PNG, GIF, WebP |
| Máximo de quadros GIF | 100 | Sem limite por quadros |
| Limite de dimensões da imagem | Sem limite rígido (o servidor pode redimensionar) | 4096 x 4096 pixels |
O limite de tamanho de imagem padrão do Mastodon é maior que o limite de 5 MB do Twitter, mas o suporte a formatos é quase idêntico. A principal diferença é a restrição de quadros GIF, que não existe no Twitter. As instâncias do Mastodon também podem ser configuradas para remover automaticamente os metadados EXIF, o que reduz o tamanho do arquivo sem ação do usuário.
Conclusão
Agora você pode identificar por que um upload de imagem no Mastodon falhou, verificando o tamanho do arquivo em relação ao limite da sua instância e confirmando o formato. Redimensione a imagem para menos de 8 MB usando uma ferramenta como Squoosh ou um editor de imagens, e converta formatos não suportados como AVIF para JPEG ou PNG. Se encontrar falhas repetidas, verifique o painel de administração em Administração > Configurações do Servidor > Uploads para obter os limites exatos. Para GIFs animados, mantenha a contagem de quadros em 100 ou menos para evitar rejeição silenciosa. Essas etapas resolverão quase todos os erros de upload de imagem em qualquer instância do Mastodon.