POSTDecodificar
Convierte Base64 de nuevo en texto o en los bytes originales. La entrada puede usar cualquiera de los dos alfabetos, omitir el relleno o llevar un prefijo data:.
https://api.base64hub.com/v1/decodePetición
Envía el Base64 como JSON en input, o como cuerpo completo con Content-Type: text/plain.
curl -s https://api.base64hub.com/v1/decode \
-H 'Content-Type: application/json' \
-d '{"input": "SGVsbG8sIGh1YiE="}'
const res = await fetch("https://api.base64hub.com/v1/decode", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ input: "SGVsbG8sIGh1YiE=" }),
});
const data = await res.json();
console.log(data.output); // Hello, hub!
import json
import urllib.request
req = urllib.request.Request(
"https://api.base64hub.com/v1/decode",
data=json.dumps({"input": "SGVsbG8sIGh1YiE="}).encode(),
headers={"Content-Type": "application/json"},
)
with urllib.request.urlopen(req) as res:
print(json.load(res)["output"]) # Hello, hub!
b64 -d SGVsbG8sIGh1YiE=
# Hello, hub!
Parámetros del cuerpo
| Nombre | Tipo | Descripción |
|---|---|---|
input obligatorio | string | El Base64 que se decodifica. |
Con Content-Type: text/plain, todo el cuerpo es la entrada, sin JSON alrededor. Este endpoint no acepta parámetros de consulta.
Qué acepta el decodificador:
- espacios, tabuladores y saltos de línea en cualquier sitio, por ejemplo Base64 ajustado al estilo MIME;
- un prefijo
data:<type>;base64,, que se elimina; - la falta del relleno
=; - el alfabeto estándar y el URL-safe, incluso mezclados.
Respuesta
{
"output": "Hello, hub!",
"utf8": true,
"bytes_out": 11
}
Cuando los bytes decodificados no son UTF-8 válido, output es null y los bytes llegan en hex. Esta es la respuesta para +/+/:
{
"output": null,
"utf8": false,
"hex": "fbffbf",
"bytes_out": 3
}
| Campo | Tipo | Descripción |
|---|---|---|
output | string o null | El texto decodificado, o null cuando los bytes no son UTF-8. |
utf8 | boolean | Si los bytes son UTF-8 válido. |
hex | string | Los bytes en hex en minúsculas. Solo aparece cuando utf8 es false. |
bytes_out | integer | Número de bytes decodificados. |
Bytes tal cual
Para recuperar un archivo, pide los bytes con Accept: application/octet-stream. El cuerpo de la respuesta es entonces el dato decodificado, sin JSON alrededor.
curl -s https://api.base64hub.com/v1/decode \
-H 'Content-Type: text/plain' \
-H 'Accept: application/octet-stream' \
--data-binary @photo.b64 -o photo.jpg
const res = await fetch("https://api.base64hub.com/v1/decode", {
method: "POST",
headers: { "Content-Type": "text/plain", Accept: "application/octet-stream" },
body: "SGk=",
});
const bytes = new Uint8Array(await res.arrayBuffer());
console.log(bytes); // Uint8Array(2) [ 72, 105 ]
import urllib.request
req = urllib.request.Request(
"https://api.base64hub.com/v1/decode",
data=b"SGk=",
headers={"Content-Type": "text/plain", "Accept": "application/octet-stream"},
)
with urllib.request.urlopen(req) as res:
print(res.read()) # b'Hi'
b64 -d -i photo.b64 -o photo.jpg
Errores
Un Base64 no válido se rechaza con 400 invalid_base64. El mensaje indica el primer problema y su posición, contada desde 0 después de quitar los espacios en blanco:
{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
| Estado | Código | Causa |
|---|---|---|
| 400 | invalid_base64 | Un carácter fuera de los dos alfabetos, un = en medio, más de dos = o una longitud que deja un único carácter en el último grupo. |
| 400 | invalid_body | JSON no válido, falta input o no es una cadena, un campo desconocido, un parámetro de consulta o un cuerpo que no es UTF-8. |
| 413 | too_large | El cuerpo supera 1 MB. |
| 415 | unsupported_media_type | Content-Type no es application/json ni text/plain. |
| 429 | ninguno | Se alcanzó el límite de peticiones; consulta los límites. |
Para comprobar una cadena sin recibir un estado de error, usa Validar.
Actualizado 22 nov 2026