Subir un archivo
  1. base64hub
  2. Docs
  3. API HTTP
  4. Codificar

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.

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

Petició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!"}'

Parámetros del cuerpo

NombreTipoDescripción
input obligatoriostringTexto 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 opcionalbooleanConserva el = final. Por defecto true.
wrap opcionalinteger, de 0 a 1000Inserta \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 @-

El límite del cuerpo es 1 MB. Para archivos más grandes usa la CLI, que trabaja en flujo.

Respuesta

200 OK · application/json
{
  "output": "SGVsbG8sIGh1YiE=",
  "variant": "standard",
  "padding": true,
  "bytes_in": 11,
  "bytes_out": 16
}
CampoTipoDescripción
outputstringEl texto Base64.
variantstringEl alfabeto usado, standard o url.
paddingbooleanSi se conservó el relleno =.
bytes_inintegerNúmero de bytes de entrada tras la conversión a UTF-8.
bytes_outintegerLongitud 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

EstadoCódigoCausa
400invalid_bodyJSON 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.
413too_largeEl cuerpo supera 1 MB.
415unsupported_media_typeContent-Type no es application/json ni application/octet-stream.
429ningunoSe alcanzó el límite de peticiones; consulta los límites.

La introducción a la API recoge todos los errores.

Actualizado 22 nov 2026