POSTCodificar
Convierte texto o bytes en Base64. Alfabeto estándar o URL-safe, con o sin relleno y, si quieres, con ajuste de línea.
https://api.base64hub.com/v1/encodePetición
Envía JSON con el texto en input. El texto se codifica 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 del cuerpo
| Nombre | Tipo | Descripción |
|---|---|---|
input obligatorio | string | Texto que se codifica. Primero se convierte a bytes UTF-8. |
variant opcional | "standard" o "url" | Alfabeto. url usa - y _ en lugar de + y /. Por defecto "standard". |
padding opcional | boolean | Conserva el = final. Por defecto true. |
wrap opcional | integer, de 0 a 1000 | Inserta \n cada N caracteres de salida, ninguno al final. 76 es MIME. Por defecto 0, sin ajuste. |
Cualquier otro campo se rechaza con 400 invalid_body.
Bytes tal cual
Para codificar un archivo o cualquier dato binario, envía los bytes como application/octet-stream. Las opciones van entonces en la 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
# -_-_
El límite del cuerpo es 1 MB. Para archivos más grandes usa la CLI, que trabaja en flujo.
Respuesta
{
"output": "SGVsbG8sIGh1YiE=",
"variant": "standard",
"padding": true,
"bytes_in": 11,
"bytes_out": 16
}
| Campo | Tipo | Descripción |
|---|---|---|
output | string | El texto Base64. |
variant | string | El alfabeto usado, standard o url. |
padding | boolean | Si se conservó el relleno =. |
bytes_in | integer | Número de bytes de entrada tras la conversión a UTF-8. |
bytes_out | integer | Longitud de output, saltos de línea incluidos. |
Con {"input": "foobar", "wrap": 4} la salida es "Zm9v\nYmFy" y bytes_out vale 9: ocho caracteres Base64 y un salto de línea. La respuesta de arriba está formateada para leerla; la API la envía en una sola línea.
Errores
| Estado | Código | Causa |
|---|---|---|
| 400 | invalid_body | JSON no válido, falta input o no es una cadena, un variant, padding o wrap incorrecto, un campo o parámetro de consulta desconocido, u opciones en la query string junto con un cuerpo JSON. |
| 413 | too_large | El cuerpo supera 1 MB. |
| 415 | unsupported_media_type | Content-Type no es application/json ni application/octet-stream. |
| 429 | ninguno | Se alcanzó el límite de peticiones; consulta los límites. |
La introducción a la API recoge todos los errores.
Actualizado 22 nov 2026