Imagen a base64

Convierte una o varias imágenes a cadenas codificadas en base64 y URI de datos. Admite conversión de formato opcional, control de calidad y redimensionado. Útil para incrustar imágenes directamente en HTML, CSS, JSON o plantillas de correo electrónico.

Endpoint de la API

POST /api/v1/tools/image/image-to-base64

Acepta datos de formulario multipart con uno o varios archivos de imagen y un campo JSON settings opcional.

Parámetros

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
outputFormat	string	No	"original"	Convertir antes de codificar: original, jpeg, png, webp, avif, jxl
quality	number	No	80	Calidad de salida para formatos con pérdidas (1 a 100)
maxWidth	number	No	0	Ancho máximo en píxeles (0 = sin redimensionar, no amplía)
maxHeight	number	No	0	Alto máximo en píxeles (0 = sin redimensionar, no amplía)

Ejemplo de solicitud

curl -X POST http://localhost:1349/api/v1/tools/image/image-to-base64 \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"outputFormat": "webp", "quality": 80, "maxWidth": 200}'

Varios archivos:

curl -X POST http://localhost:1349/api/v1/tools/image/image-to-base64 \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F 'settings={"outputFormat": "original"}'

Ejemplo de respuesta

{
  "results": [
    {
      "filename": "icon.png",
      "mimeType": "image/webp",
      "width": 200,
      "height": 200,
      "originalSize": 45000,
      "encodedSize": 28800,
      "overheadPercent": -36.0,
      "base64": "UklGRlYAAABXRUJQ...",
      "dataUri": "data:image/webp;base64,UklGRlYAAABXRUJQ..."
    }
  ],
  "errors": []
}

Campos de la respuesta

Campo	Tipo	Descripción
results	array	Imágenes convertidas correctamente
errors	array	Imágenes que no pudieron procesarse (con nombre de archivo y mensaje de error)

Objeto de resultado

Campo	Tipo	Descripción
filename	string	Nombre de archivo original
mimeType	string	Tipo MIME de la salida codificada
width	number	Ancho final en píxeles (tras cualquier redimensionado)
height	number	Alto final en píxeles (tras cualquier redimensionado)
originalSize	number	Tamaño del archivo original en bytes
encodedSize	number	Tamaño de la cadena en base64 en bytes
overheadPercent	number	Diferencia de tamaño en porcentaje frente al original (positivo = mayor, negativo = menor)
base64	string	Datos de imagen codificados en base64 sin procesar
dataUri	string	URI de datos completo listo para usar en atributos src

Notas

• La codificación en base64 suele aumentar el tamaño aproximadamente un 33 % en comparación con el archivo binario. El campo overheadPercent muestra la diferencia real.
• Cuando outputFormat es "original", los archivos HEIC/HEIF se convierten a JPEG (ya que los navegadores no pueden mostrar HEIC en URI de datos).
• Las opciones maxWidth y maxHeight redimensionan usando fit: inside con withoutEnlargement, por lo que las imágenes más pequeñas que las dimensiones especificadas no se amplían.
• Se pueden procesar varios archivos en una sola solicitud. Cada archivo se procesa de forma independiente, y los fallos no impiden que otros archivos se procesen correctamente.
• Los archivos SVG se transfieren tal cual como image/svg+xml sin volver a codificarse (salvo que se solicite una conversión de formato).
• Este es un endpoint de solo lectura. No produce un archivo descargable ni un jobId. Los datos en base64 se devuelven directamente en el cuerpo de la respuesta.