Enviar um arquivo
  1. base64hub
  2. Downloads
  3. API HTTP
v1.0.0 · Código aberto · MIT

API Base64 grátis para codificar, decodificar e validar

https://api.base64hub.com/v1 codifica, decodifica e valida Base64 por HTTPS simples. Sem cadastro, sem chave, JSON na entrada e na saída, e CORS para funcionar também no navegador.

Grátis sem conta, sem chave MIT licença de código aberto Zero dependências em tempo de execução Atualizado 22 de nov. de 2026

Endpoints

MétodoCaminhoO que faz
POST/v1/encodetexto ou bytes puros para Base64; padrão ou URL-safe, preenchimento, quebra de linha
POST/v1/decodeBase64 para texto, hex no caso de binário, ou os bytes puros
POST/v1/validatese é Base64, qual alfabeto, se tem preenchimento, quantos bytes
GET/v1/healthstatus e versão
GET/v1/openapi.jsona descrição OpenAPI 3.1

Requisições e respostas são JSON. O encode também aceita bytes puros como application/octet-stream, e o decode pode devolver bytes puros quando você os pede com Accept: application/octet-stream.

Uma requisição e a resposta dela

Codificar uma string como Base64 URL-safe sem preenchimento:

curl -s https://api.base64hub.com/v1/encode \
  -H 'Content-Type: application/json' \
  -d '{"input": "Привет", "variant": "url", "padding": false}'
{"output":"0J_RgNC40LLQtdGC","variant":"url","padding":false,"bytes_in":12,"bytes_out":16}

O decode funciona do mesmo jeito e avisa quando os bytes não são texto:

curl -s https://api.base64hub.com/v1/decode \
  -H 'Content-Type: text/plain' -d '+/+/'
{"output":null,"utf8":false,"hex":"fbffbf","bytes_out":3}

O decodificador é tolerante de propósito: espaços e quebras de linha, um prefixo data:...;base64,, preenchimento ausente e qualquer um dos dois alfabetos são aceitos. Os erros de verdade voltam como 400 invalid_base64, com o caractere inválido e a posição dele, por exemplo invalid character '!' at position 4.

Limites e comportamento

  • Autenticação: nenhuma, sem chave nem token.
  • Limite de requisições: 20 a cada 10 segundos por endereço IP. Acima do limite, você recebe status 429 da Cloudflare.
  • Tamanho do corpo: até 1 MB. Corpos maiores recebem 413 too_large.
  • Entradas rígidas: campos JSON e parâmetros de query desconhecidos são rejeitados com 400 invalid_body, então um erro de digitação no nome de uma opção nunca passa despercebido.
  • CORS: Access-Control-Allow-Origin: * em toda resposta, preflight respondido.
  • Cache: toda resposta vem com Cache-Control: no-store.

A visão geral da API tem a tabela completa de erros e as regras de cada tipo de conteúdo.

Quando usar uma API para Base64

Calcular Base64 custa pouco, e toda linguagem já tem isso embutido: btoa nos navegadores, Buffer no Node.js, o módulo base64 no Python. Chamar um serviço web para isso faz sentido quando:

  • você está numa ferramenta no-code, numa planilha ou num construtor de webhooks que faz requisições HTTP, mas não executa código;
  • você quer a mesma decodificação tolerante e a mesma validação em todas as linguagens, sem precisar portá-las;
  • você está testando ou ensinando e quer uma resposta de referência para comparar.

Para qualquer coisa sensível, como tokens ou chaves privadas, prefira uma ferramenta local: as ferramentas no navegador deste site, a CLI ou os pacotes npm e Python dão resultados idênticos sem que os dados saiam da sua máquina.

Perguntas frequentes

A API do base64hub é grátis mesmo?

Sim. Não há chave nem conta. Um limite de 20 requisições a cada 10 segundos por endereço IP mantém a API disponível para todos.

A API guarda o que eu envio?

Não. Ela roda como um Cloudflare Worker sem armazenamento e não registra o corpo das requisições. Mesmo assim, não mande segredos para nenhum serviço web quando uma ferramenta local resolve; a CLI b64 dá os mesmos resultados offline.

Dá para chamar a API Base64 com JavaScript no navegador?

Sim. Toda resposta traz Access-Control-Allow-Origin: * e as requisições de preflight são respondidas, então o fetch() funciona a partir de qualquer origem.

Qual o tamanho máximo de arquivo que a API codifica?

O corpo da requisição é limitado a 1 MB. Para arquivos maiores, use a CLI, que trabalha em fluxo, ou a ferramenta Arquivo para Base64 no seu navegador.

Mais do base64hub