Como converter Base64 em imagem (e uma imagem em Base64)
Transforme uma string Base64 ou um data URI de imagem em PNG, JPG ou GIF para baixar, ou uma imagem em Base64. Resolva strings truncadas e caracteres inválidos.
Atualizado em 7 de novembro de 20267 min de leitura
Para converter Base64 em imagem, cole a string no decodificador Base64. Ele remove o prefixo data:image/png;base64, se houver, decodifica os bytes, percebe pelos primeiros bytes que o resultado é um PNG, JPEG ou GIF, mostra uma prévia e deixa você baixar o arquivo com a extensão certa. Para fazer o caminho inverso, solte a imagem no codificador Base64 e ative Envolver como data URI. O restante deste guia cobre os detalhes que decidem se funciona: o que colar, o que os erros significam e quando incorporar uma imagem como texto é má ideia. Para saber o que é Base64, veja o que é a codificação Base64.
O que você tem em mãos: uma string simples ou um data URI
As imagens aparecem como texto de duas formas. Uma string Base64 simples é só a sequência de caracteres, que costuma começar com iVBORw0KGgo (um PNG) ou /9j/ (um JPEG). Um data URI é a mesma sequência com um rótulo na frente, como data:image/png;base64, seguido da string. As ferramentas de desenvolvedor do navegador, arquivos CSS, e-mails em HTML e respostas de API costumam entregar a segunda forma. O decodificador aceita as duas, então você nunca precisa cortar o prefixo à mão.
| O que você colou | Aparência | O que o decodificador faz |
|---|---|---|
| String simples | iVBORw0KGgoAAAANS… | Decodifica e identifica o arquivo pelos bytes |
| Data URI | data:image/jpeg;base64,/9j/4AAQ… | Remove o prefixo e decodifica o resto |
| String URL-safe | Usa - e _ no lugar de + e / | Reconhecida automaticamente, com ou sem preenchimento |
| Linhas quebradas | Dividida em linhas de 64 ou 76 caracteres | As quebras de linha são ignoradas no modo padrão |
Convertendo Base64 em imagem, passo a passo
Abra o decodificador
Acesse o decodificador Base64. Deixe Formato de entrada em Auto para que ele detecte um data URI sozinho.
Cole a string
Cole tudo, com o prefixo, na caixa de Base64. Até 256 KB a decodificação acontece enquanto você cola; para entradas maiores, toque em Decodificar. Você também pode soltar um arquivo .txt ou .b64 que contenha a string.
Confira a prévia e a linha Detectado
O painel de resultado mostra o formato encontrado, o tamanho decodificado em bytes e, nas imagens, uma prévia. Se a linha Detectado disser PNG, JPG, GIF, WebP, AVIF ou algo parecido, você tem uma imagem de verdade.
Baixe
Toque em Baixar. O arquivo é salvo com a extensão que os próprios bytes indicam, então um PNG decodificado vira .png e abre com um clique duplo.
Cole uma string ou um data URI e baixe a imagem. Grátis: até 25 MB de Base64, uma entrada por vez, com todos os formatos e visualizações incluídos. Pro: até 20 entradas ao mesmo tempo, baixadas em um único ZIP. Tudo roda no seu dispositivo, não nos nossos servidores.
Decodificar Base64 em imagemComo o tipo da imagem é detectado
O Base64 não diz nada sobre o conteúdo, então a ferramenta lê a assinatura com que quase todo formato binário começa. Entre as imagens, ela reconhece PNG, JPEG, GIF, WebP, BMP, ICO, TIFF, AVIF e HEIC. Também reconhece PDFs, arquivos baseados em ZIP como DOCX, áudio, vídeo e fontes, e assim você logo percebe se recebeu algo que não é uma imagem.
| Os bytes decodificados começam com | Detectado como | Salvo como |
|---|---|---|
| 89 50 4E 47 (as letras PNG) | Imagem PNG | .png |
| FF D8 FF | Imagem JPEG | .jpg |
| GIF87a ou GIF89a | Imagem GIF | .gif |
| RIFF … WEBP | Imagem WebP | .webp |
| Uma tag <svg de abertura | SVG, um formato de texto | .svg |
| Nada reconhecido, sem bytes NUL | Texto simples | .txt |
O SVG é a exceção. É texto, não binário, então é identificado pela tag de abertura e oferecido como arquivo .svg em vez de aparecer como prévia de imagem. Se uma string decodificar para um XML legível que mencione svg, salve-a e abra em um navegador.
Convertendo uma imagem em Base64 ou data URI
Abra o codificador
Acesse o codificador Base64 e solte a imagem onde ele pede para soltar um arquivo. A versão grátis aceita arquivos de até 25 MB, um por vez.
Escolha o formato
Ative Envolver como data URI se a string for para HTML ou CSS. O tipo de mídia é lido dos bytes do próprio arquivo e acrescentado ao prefixo. Um data URI precisa ser uma única linha contínua, com o alfabeto padrão e preenchimento; por isso a ferramenta desativa para você o URL-safe, a quebra de linha e o modo linha a linha, e avisa que fez isso.
Codifique e copie
Toque em Codificar e depois copie ou baixe o resultado. Em resultados muito grandes, só os primeiros 32.768 caracteres aparecem na tela como prévia, mas Copiar e Baixar sempre entregam a string completa.
Deixe o interruptor de data URI desligado quando quiser apenas a string pura, por exemplo para colocar num campo JSON que uma API vai decodificar sozinha. Se quiser os dois sentidos numa única página, o codificador e decodificador Base64 combinado tem ambos.
Erros comuns e como corrigi-los
Quando uma string não pode ser decodificada, a ferramenta não diz apenas que é inválida. Ela informa a posição do caractere, a linha, a coluna e o próprio caractere, o que permite consertar uma string com milhares de caracteres.
| Mensagem | Causa habitual | Solução |
|---|---|---|
| Base64 inválido | Um caractere solto, como aspas, vírgula ou espaço não separável, trazido ao copiar | Vá até a posição indicada e apague o caractere |
| A string está truncada | Parte da string foi cortada, muitas vezes por um app de mensagens, uma célula de planilha ou um limite de texto | Copie o valor completo de novo a partir da origem |
| Dados depois do preenchimento = | Duas strings Base64 foram coladas uma na outra | Separe-as e decodifique cada uma isoladamente |
| Decodifica, mas não é uma imagem | A string contém um PDF, um ZIP ou texto simples | Leia a linha Detectado e use o formato correspondente |
Strings URL-safe e espaços em branco
Alguns sistemas trocam + e / por - e _ para que a string caiba numa URL. Não é preciso converter de volta: o decodificador reconhece os dois alfabetos, com ou sem o preenchimento = no final. Espaços e quebras de linha são removidos antes de decodificar. O preenchimento que faltar é acrescentado para você, a menos que ative o Modo estrito, que recusa entradas malformadas em vez de repará-las. Deixe o modo estrito desligado para uma recuperação comum.
Uma armadilha é a string que chegou codificada em porcentagem, com %2B e %3D no lugar de + e =. É uma segunda camada de codificação por cima. Passe-a primeiro pelo decodificador de URL e só depois decodifique o Base64.
Quando incorporar uma imagem como Base64 é má ideia
O Base64 escreve quatro caracteres para cada três bytes, então o texto fica cerca de um terço maior que o arquivo, antes de contar o prefixo e as quebras de linha. Uma imagem de 1 MB vira aproximadamente 1,37 MB de texto. É um preço justo para um ícone de 2 KB e ruim para uma fotografia.
| Situação | Incorporar como Base64? | Por quê |
|---|---|---|
| Ícone ou marcador pequeno usado em uma só página | Sim | Economiza uma requisição e nada é grande |
| Imagem em assinatura de e-mail ou arquivo Markdown | Muitas vezes sim | Pode não haver onde hospedar um arquivo |
| Foto ou imagem de destaque | Não | Cerca de 33% mais pesada, e a página não consegue mostrar nada até que tudo seja baixado |
| Imagem usada em muitas páginas | Não | Um arquivo separado fica em cache uma vez; o texto incorporado é baixado de novo a cada página |
| Imagem que muda com frequência | Não | Cada mudança invalida todo o arquivo HTML ou CSS que a contém |
O ponto do cache é o mais importante. Um arquivo de imagem comum pode ser guardado pelo navegador e reutilizado em todas as páginas. Uma imagem incorporada faz parte do documento, então é baixada de novo sempre que o documento é. Se for incorporar uma imagem, reduza-a antes com Comprimir imagem para o texto ficar curto.
Perguntas frequentes
Como converto uma string Base64 em imagem?
Cole a string no decodificador Base64. Ele detecta o tipo da imagem pelos bytes decodificados, mostra uma prévia e deixa você baixar o arquivo com a extensão certa, como .png ou .jpg. Um prefixo data:image é removido automaticamente.
Preciso remover antes a parte data:image/png;base64,?
Não. Com Formato de entrada em Auto, o decodificador reconhece um data URI, remove o prefixo e decodifica o resto. Colar o data URI inteiro é o jeito mais fácil.
Como converto uma imagem em Base64?
Solte a imagem no codificador Base64 e toque em Codificar. Ative Envolver como data URI se precisar do prefixo data:image/...;base64, para HTML ou CSS. A versão grátis aceita arquivos de até 25 MB, um por vez.
Por que minha string Base64 diz que está truncada ou inválida?
Em geral, parte da string se perdeu ou um caractere extra entrou ao copiar. O erro mostra a posição, a linha e a coluna exatas do primeiro caractere incorreto, e string truncada significa que falta o final, então copie o valor completo de novo.
O decodificador aceita Base64 URL-safe com - e _?
Sim. Ele reconhece automaticamente o alfabeto URL-safe, com ou sem preenchimento. Espaços e quebras de linha são ignorados no modo padrão.
Incorporar uma imagem como Base64 ajuda na velocidade da página?
Só no caso de imagens minúsculas. O Base64 acrescenta cerca de um terço ao tamanho e a imagem não pode ser guardada em cache separadamente, então fotos e imagens compartilhadas são melhores como arquivos normais.