ForHosting KIT · Imágenes

Añadir borde a una imagen

Añadir un borde cambia el tamaño del lienzo de una imagen, aunque la fotografía original permanezca intacta en su interior.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Esta calculadora toma la anchura y la altura originales en píxeles, aplica el mismo grosor de borde arriba, a la derecha, abajo y a la izquierda, y devuelve las dimensiones exteriores exactas. También conserva el color indicado en el resultado para que el cálculo pueda acompañar una especificación de diseño, una tarea de exportación o un flujo automatizado de imágenes.

Calcule el tamaño del lienzo antes de exportar

Un borde ocupa espacio fuera de cada extremo de la imagen original. Por eso, un borde de 20 píxeles no añade solo 20 píxeles a la anchura o la altura: suma 20 a la izquierda y otros 20 a la derecha, además de 20 arriba y abajo. Introduzca la anchura y la altura originales en píxeles, el grosor de un lado del borde y el color previsto. La calculadora devuelve las medidas originales junto con la nueva anchura y altura exteriores, lo que permite revisar el cambio con facilidad. Resulta útil antes de abrir un editor de imágenes, preparar una regla de procesamiento por lotes o reservar espacio en una maqueta. El cálculo no redimensiona, recorta, estira ni codifica ninguna imagen. Solo resuelve la cuestión dimensional, por lo que no existe duda sobre si ha cambiado el área del contenido original. Se admite un borde de grosor cero, que mantiene las dimensiones exteriores iguales a las originales y permite usar una única ruta de cálculo incluso cuando no se necesita un borde visible.

Comprenda la fórmula del borde

La fórmula es sencilla y predecible: la anchura exterior equivale a la anchura original más dos veces el grosor del borde, y la altura exterior equivale a la altura original más dos veces ese grosor. La multiplicación por dos representa los dos lados opuestos de cada eje. Por ejemplo, una imagen de 1200 píxeles de ancho y 800 de alto con un borde de 24 píxeles pasa a medir 1248 por 848 píxeles. El color no altera ninguna dimensión, pero se devuelve para que el código posterior conserve el ajuste visual junto con las medidas. La anchura y la altura originales deben ser números enteros positivos porque las dimensiones describen un lienzo ráster real. El grosor puede ser cero o un número finito positivo, lo que admite tanto medidas fraccionarias de maquetación como píxeles enteros habituales. Los valores negativos se rechazan porque describen un recorte o una geometría interior, no la adición de un borde exterior. Utilice un cálculo de recorte independiente si desea eliminar píxeles de los extremos.

Utilice el resultado en diseño y automatización

Las dimensiones exteriores obtenidas pueden emplearse directamente para planificar maquetas, crear lienzos, validar recursos o estimar almacenamiento. Un desarrollador puede calcular el lienzo necesario antes de dibujar la imagen original desplazada según el borde. Un diseñador puede comprobar si una miniatura enmarcada sigue cabiendo en una tarjeta fija o en el espacio de un mercado digital. Un equipo de producción puede comparar el resultado con el tamaño máximo de carga antes de procesar miles de recursos. Como la operación usa únicamente aritmética determinista, las mismas entradas siempre generan el mismo resultado, sin solicitudes de red, cargas de archivos, valores aleatorios ni transformaciones ocultas. El color indicado se trata como una etiqueta, no se interpreta ni convierte; así, un código hexadecimal, un nombre CSS o un identificador propio puede conservarse tras eliminar los espacios exteriores. El precio de la API es de $0.002 por solicitud. La respuesta incluye las medidas originales y exteriores, lo que facilita la lectura de los registros y evita confundir el origen con el lienzo final.

Prepare un lienzo con borde

Calcule las dimensiones exactas del lienzo antes de colocar una imagen original sin cambios dentro de un borde de color.

Valide recursos para mercados digitales

Compruebe si una imagen de producto respetará el límite de carga o maquetación después de añadir un borde uniforme.

Planifique tareas de imágenes por lotes

Obtenga dimensiones de salida previsibles para procesos automatizados antes de dedicar recursos a renderizar cada imagen.

¿Cómo se calculan las nuevas dimensiones?

Se suma dos veces el grosor del borde a ambas dimensiones, ya que aparece en dos lados de cada eje.

¿Esta capacidad modifica o carga mi imagen?

No. Solo recibe dimensiones y ajustes del borde, y devuelve las medidas calculadas sin leer ni modificar un archivo de imagen.

¿Puede ser cero el grosor del borde?

Sí. Un borde de grosor cero es válido y devuelve dimensiones exteriores iguales a las originales.

¿Qué ocurre si el grosor del borde es negativo?

La solicitud falla con un error de entrada no válida, porque un valor negativo describe la eliminación de espacio, no un borde exterior.

¿Qué formatos de color puedo indicar?

Puede usar cualquier etiqueta de color no vacía, como un nombre CSS, una notación hexadecimal o un identificador de su flujo. El valor se conserva sin interpretarlo.

¿Cuánto cuesta un cálculo mediante la API?

Cada solicitud API cuesta $0.002. El cálculo también sirve para el ejecutor del navegador porque no necesita acceso a la red.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/image/add-border

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/image/add-border \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1200,"height":800,"border_width":24,"color":"#1d4ed8"}'
{
  "width": 1200,
  "height": 800,
  "border_width": 24,
  "color": "#1d4ed8"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.add_border",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_mb15
max_megapixels12
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →