Enviar um arquivo
  1. base64hub
  2. Docs
  3. API HTTP
  4. Codificar

POSTCodificar

Transforme texto ou bytes em Base64. Alfabeto padrão ou URL-safe, com ou sem preenchimento, com quebra de linha opcional.

POSThttps://api.base64hub.com/v1/encode

Requisição

Envie um JSON com o texto em input. O texto é codificado como UTF-8.

curl -s https://api.base64hub.com/v1/encode \
  -H 'Content-Type: application/json' \
  -d '{"input": "Hello, hub!"}'

Parâmetros do corpo

NomeTipoDescrição
input obrigatóriostringTexto a codificar. Ele é convertido em bytes UTF-8 antes.
variant opcional"standard" ou "url"Alfabeto. url usa - e _ no lugar de + e /. Padrão: "standard".
padding opcionalbooleanMantém o = do final. Padrão: true.
wrap opcionalinteger, de 0 a 1000Insere \n a cada N caracteres de saída, nenhum no final. 76 é MIME. Padrão: 0, sem quebra.

Qualquer outro campo é rejeitado com 400 invalid_body.

Bytes puros

Para codificar um arquivo ou qualquer dado binário, envie os bytes como application/octet-stream. Nesse caso, as opções vão na query string: variant=url, padding=false, wrap=76.

printf '\xfb\xff\xbf' | curl -s \
  'https://api.base64hub.com/v1/encode?variant=url&padding=false' \
  -H 'Content-Type: application/octet-stream' \
  --data-binary @-

O limite do corpo é 1 MB. Para arquivos maiores, use a CLI, que trabalha em fluxo.

Resposta

200 OK · application/json
{
  "output": "SGVsbG8sIGh1YiE=",
  "variant": "standard",
  "padding": true,
  "bytes_in": 11,
  "bytes_out": 16
}
CampoTipoDescrição
outputstringO texto Base64.
variantstringO alfabeto usado, standard ou url.
paddingbooleanSe o preenchimento = foi mantido.
bytes_inintegerNúmero de bytes de entrada depois da conversão para UTF-8.
bytes_outintegerTamanho de output, quebras de linha incluídas.

Com {"input": "foobar", "wrap": 4}, a saída é "Zm9v\nYmFy" e bytes_out é 9: oito caracteres Base64 e uma quebra de linha. A resposta acima está formatada para leitura; a API a envia numa linha só.

Erros

StatusCódigoCausa
400invalid_bodyJSON inválido, input ausente ou que não é string, variant, padding ou wrap inválido, um campo ou parâmetro de query desconhecido, ou opções na query enviadas com corpo JSON.
413too_largeO corpo passa de 1 MB.
415unsupported_media_typeO Content-Type não é application/json nem application/octet-stream.
429nenhumLimite de requisições atingido; veja os limites.

A visão geral da API lista todos os erros.

Atualizado 22 de nov. de 2026