IA no seu dispositivo — profissional e privado.

Documentos

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ê colouAparênciaO que o decodificador faz
String simplesiVBORw0KGgoAAAANS…Decodifica e identifica o arquivo pelos bytes
Data URIdata:image/jpeg;base64,/9j/4AAQ…Remove o prefixo e decodifica o resto
String URL-safeUsa - e _ no lugar de + e /Reconhecida automaticamente, com ou sem preenchimento
Linhas quebradasDividida em linhas de 64 ou 76 caracteresAs quebras de linha são ignoradas no modo padrão

Convertendo Base64 em imagem, passo a passo

1

Abra o decodificador

Acesse o decodificador Base64. Deixe Formato de entrada em Auto para que ele detecte um data URI sozinho.

2

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.

3

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.

4

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 imagem

Como 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 comDetectado comoSalvo como
89 50 4E 47 (as letras PNG)Imagem PNG.png
FF D8 FFImagem JPEG.jpg
GIF87a ou GIF89aImagem GIF.gif
RIFF … WEBPImagem WebP.webp
Uma tag <svg de aberturaSVG, um formato de texto.svg
Nada reconhecido, sem bytes NULTexto 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

1

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.

2

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.

3

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.

MensagemCausa habitualSolução
Base64 inválidoUm caractere solto, como aspas, vírgula ou espaço não separável, trazido ao copiarVá até a posição indicada e apague o caractere
A string está truncadaParte da string foi cortada, muitas vezes por um app de mensagens, uma célula de planilha ou um limite de textoCopie o valor completo de novo a partir da origem
Dados depois do preenchimento =Duas strings Base64 foram coladas uma na outraSepare-as e decodifique cada uma isoladamente
Decodifica, mas não é uma imagemA string contém um PDF, um ZIP ou texto simplesLeia 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çãoIncorporar como Base64?Por quê
Ícone ou marcador pequeno usado em uma só páginaSimEconomiza uma requisição e nada é grande
Imagem em assinatura de e-mail ou arquivo MarkdownMuitas vezes simPode não haver onde hospedar um arquivo
Foto ou imagem de destaqueNãoCerca de 33% mais pesada, e a página não consegue mostrar nada até que tudo seja baixado
Imagem usada em muitas páginasNãoUm arquivo separado fica em cache uma vez; o texto incorporado é baixado de novo a cada página
Imagem que muda com frequênciaNãoCada 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.

Continue lendo

Mais sobre Documentos →