POSTCodificar
Transforme texto ou bytes em Base64. Alfabeto padrão ou URL-safe, com ou sem preenchimento, com quebra de linha opcional.
https://api.base64hub.com/v1/encodeRequisiçã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!"}'
const res = await fetch("https://api.base64hub.com/v1/encode", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ input: "Hello, hub!" }),
});
const { output } = await res.json();
console.log(output); // SGVsbG8sIGh1YiE=
import json
import urllib.request
req = urllib.request.Request(
"https://api.base64hub.com/v1/encode",
data=json.dumps({"input": "Hello, hub!"}).encode(),
headers={"Content-Type": "application/json"},
)
with urllib.request.urlopen(req) as res:
print(json.load(res)["output"]) # SGVsbG8sIGh1YiE=
b64 "Hello, hub!"
# SGVsbG8sIGh1YiE=
Parâmetros do corpo
| Nome | Tipo | Descrição |
|---|---|---|
input obrigatório | string | Texto 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 opcional | boolean | Mantém o = do final. Padrão: true. |
wrap opcional | integer, de 0 a 1000 | Insere \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 @-
const bytes = new Uint8Array([0xfb, 0xff, 0xbf]);
const res = await fetch(
"https://api.base64hub.com/v1/encode?variant=url&padding=false",
{ method: "POST", headers: { "Content-Type": "application/octet-stream" }, body: bytes },
);
console.log((await res.json()).output); // -_-_
import json
import urllib.request
req = urllib.request.Request(
"https://api.base64hub.com/v1/encode?variant=url&padding=false",
data=b"\xfb\xff\xbf",
headers={"Content-Type": "application/octet-stream"},
)
with urllib.request.urlopen(req) as res:
print(json.load(res)["output"]) # -_-_
printf '\xfb\xff\xbf' | b64 --url --no-pad
# -_-_
O limite do corpo é 1 MB. Para arquivos maiores, use a CLI, que trabalha em fluxo.
Resposta
{
"output": "SGVsbG8sIGh1YiE=",
"variant": "standard",
"padding": true,
"bytes_in": 11,
"bytes_out": 16
}
| Campo | Tipo | Descrição |
|---|---|---|
output | string | O texto Base64. |
variant | string | O alfabeto usado, standard ou url. |
padding | boolean | Se o preenchimento = foi mantido. |
bytes_in | integer | Número de bytes de entrada depois da conversão para UTF-8. |
bytes_out | integer | Tamanho 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
| Status | Código | Causa |
|---|---|---|
| 400 | invalid_body | JSON 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. |
| 413 | too_large | O corpo passa de 1 MB. |
| 415 | unsupported_media_type | O Content-Type não é application/json nem application/octet-stream. |
| 429 | nenhum | Limite de requisições atingido; veja os limites. |
A visão geral da API lista todos os erros.
Atualizado 22 de nov. de 2026