Base64 para Imagem

O Base64 para Imagem é uma ferramenta gratuita que converte dados de imagem codificados em Base64 novamente em uma imagem.

Como o Base64 representa uma imagem?

O Base64 representa uma imagem convertendo seus bytes binários em um conjunto restrito de caracteres de texto imprimíveis. Ele existe porque alguns sistemas foram criados para transportar texto, não dados binários brutos. A codificação dos bytes facilita sua inclusão em emails, JSON, HTML e outros formatos baseados em texto.

O alfabeto Base64 padrão usa letras maiúsculas e minúsculas, números, sinais de adição e barras. Um sinal de igual pode aparecer no final como preenchimento. Normalmente, cada três bytes de entrada se transformam em quatro caracteres Base64. Por isso, o conteúdo codificado fica cerca de um terço maior que os dados originais.

Este pequeno exemplo de texto mostra claramente como o processo funciona:

• Bytes originais interpretados como texto: Man
• Resultado em Base64: TWFu

Uma imagem passa pelo mesmo processo, mas seus bytes originais descrevem um arquivo PNG, JPEG, GIF, WebP ou de outro formato de imagem, em vez de texto legível. O Base64 bruto não informa por si só o tipo da imagem. Essa informação pode aparecer em uma URL de dados ou ser identificada pela assinatura do arquivo decodificado.

Como converter Base64 novamente em imagem?

Cole os dados da imagem em Base64 na ferramenta e envie para conversão. O resultado retornado será uma imagem. Antes, confira se o valor contém Base64 bruto ou uma URL de dados completa.

1. Localize o valor codificado e copie-o sem as aspas ao redor, seja do JSON, do CSS ou do código-fonte.
2. Procure um prefixo de URL de dados, como data:image/png;base64,. O conteúdo Base64 propriamente dito começa depois da vírgula.
3. Se a URL de dados completa for rejeitada, remova o prefixo e envie apenas o conteúdo codificado, pois nem todos os decodificadores aceitam esse invólucro.
4. Antes de usar a imagem em outro lugar, confira se o conteúdo, as dimensões e o formato estão corretos.

Espaços e quebras de linha podem surgir quando um programa de email divide um valor Base64 muito longo. Alguns decodificadores ignoram esses espaços em branco, enquanto outros, mais rigorosos, rejeitam a entrada. Não acrescente pontuação nem texto explicativo ao conteúdo. Números são caracteres Base64 válidos, mas uma sequência formada apenas por caracteres válidos não é necessariamente uma imagem.

Um valor Base64 vazio representa zero bytes e, portanto, não pode gerar uma imagem utilizável. Valores muito longos também ocupam bastante espaço, pois o Base64 aumenta o tamanho dos dados originais. Além disso, o processamento exige que toda a sequência codificada seja transferida e decodificada.

Por que minha imagem em Base64 não é decodificada?

Uma imagem em Base64 geralmente não é decodificada porque o texto está malformado ou incompleto, usa o alfabeto errado ou não contém bytes de imagem. A codificação dupla também pode ser a causa, caso a origem tenha codificado o conteúdo mais de uma vez. A posição e a forma como a falha aparece podem ajudar a identificar o problema.

• Entrada truncada. Ao copiar de logs, visualizadores de banco de dados ou sistemas de mensagens, o final de um valor longo pode ser cortado. A ausência de caracteres normalmente deixa os bytes decodificados incompletos.
• Variante ou alfabeto incorreto. O Base64 padrão usa + e /, enquanto o Base64url geralmente usa - e _. Um decodificador configurado para a outra variante pode rejeitar a entrada.
• Preenchimento ausente. Valores Base64 podem terminar com um ou dois sinais de igual. Alguns sistemas omitem esse preenchimento e alguns decodificadores conseguem reconstruí-lo, mas implementações rigorosas podem exigi-lo.
• Dados binários que não são uma imagem. O Base64 pode representar um PDF, arquivo compactado, fonte ou qualquer outro conjunto de bytes. Portanto, um Base64 válido não garante que o resultado seja uma imagem válida.
• Confusão com a codificação de texto. Letras acentuadas, emojis e caracteres não latinos não fazem parte do alfabeto Base64. Antes da codificação em Base64, esses caracteres precisam ser representados como bytes, normalmente em UTF-8.
• Codificação dupla. Se a primeira decodificação gerar outra sequência longa contendo apenas caracteres Base64, é possível que a origem tenha sido codificada duas vezes. Decodifique o valor intermediário mais uma vez somente se a origem confirmar que esse resultado é esperado.

Se um Decodificador Base64 genérico produzir conteúdo ilegível, isso não significa necessariamente que a decodificação falhou. Bytes de imagem são binários e não devem parecer legíveis como texto. Use o Decodificador Base64 para inspecionar conteúdo que não seja uma imagem e o Imagem para Base64 quando precisar fazer a operação inversa.

Onde os dados de imagem em Base64 são usados?

Dados de imagem em Base64 aparecem quando arquivos binários precisam ser transportados por um campo ou documento orientado a texto. Exemplos comuns incluem imagens incorporadas em URLs de dados no HTML ou CSS, propriedades de imagem em conteúdos JSON de APIs e partes MIME de emails.

Eles também podem aparecer em strings de consulta. Nesse caso, os analisadores de parâmetros da aplicação podem interpretar incorretamente caracteres do Base64 padrão, principalmente analisadores no formato de formulário que tratam sinais de adição como espaços ou sinais de igual como delimitadores. O Base64url substitui os caracteres problemáticos do alfabeto e frequentemente omite o preenchimento, o que o torna mais adequado para URLs e tokens.

Nomes de domínio internacionalizados não usam Base64. No sistema IDNA, rótulos ASCII permanecem inalterados, enquanto U-labels não ASCII podem ser representados como A-labels por meio de Punycode. Um valor Base64 pode aparecer em outra parte de uma URL, como na string de consulta. Essa diferença é importante ao diagnosticar um valor copiado do endereço exibido no navegador.

O JSON não tem um tipo binário nativo. Por isso, algumas APIs colocam o conteúdo de imagens em Base64 dentro de uma string entre aspas. Isso é conveniente para o intercâmbio baseado em texto, mas aumenta o tamanho dos dados. Para envios grandes ou frequentes, geralmente é mais apropriado fazer um upload normal do arquivo binário.

Codificação Base64, sigilo e processamento no servidor

Base64 é uma codificação, não uma criptografia, e não oferece sigilo. Qualquer pessoa que tenha acesso ao valor pode decodificá-lo sem senha nem chave. Portanto, credenciais, fotografias privadas e documentos confidenciais não devem ser protegidos apenas por sua conversão em Base64.

Nesta ferramenta, o processamento é feito no servidor. A entrada é enviada ao servidor por HTTPS e não é armazenada. O HTTPS protege a conexão enquanto os dados estão em trânsito, mas não transforma o valor Base64 em conteúdo criptografado nem torna segura uma origem não confiável.

A decodificação também não verifica se uma imagem é inofensiva. Tenha com imagens decodificadas de valores Base64 recebidos de remetentes desconhecidos o mesmo cuidado que teria com outras imagens baixadas.

Perguntas frequentes

Como saber o formato da imagem usando apenas o Base64 bruto?

Às vezes é possível, mas o alfabeto Base64 sozinho não declara o formato. Arquivos decodificados contêm assinaturas, muitas vezes chamadas de magic bytes, que os programas podem usar para diferenciar formatos como PNG, JPEG e GIF. Uma URL de dados também pode declarar um tipo de mídia, embora esse rótulo possa estar errado e não deva prevalecer sobre os bytes reais.

Decodificar Base64 reduz a qualidade da imagem?

Não. Uma decodificação Base64 correta restaura os bytes originais e não recomprime a imagem. A qualidade, os dados de cor e os metadados incorporados permanecem inalterados, a menos que outro programa edite ou converta o arquivo decodificado depois.

O Base64 pode conter uma imagem SVG?

Sim, dados SVG podem ser codificados em Base64, embora a exibição dependa da compatibilidade do programa que os recebe. SVG é um formato baseado em XML e pode conter scripts, links ou referências externas. Portanto, não presuma que seja seguro abrir um SVG em Base64 vindo de uma origem desconhecida.

Por que uma imagem em Base64 fica maior que o arquivo original?

O Base64 gera quatro caracteres de texto para cada três bytes dos dados de origem, e o bloco final pode conter preenchimento. A RFC 4648 exige esse preenchimento, a menos que a especificação aplicável permita explicitamente sua omissão. Assim, o resultado fica cerca de um terço maior antes mesmo de acrescentar um prefixo de URL de dados, aspas do JSON ou a sobrecarga de transporte. Quando o sistema aceita uploads comuns de arquivos, enviar a imagem binária original geralmente consome menos dados.