ForHosting KIT · Imágenes

Redondear esquinas de imagen

Redondear las esquinas de una imagen parece sencillo, pero el radio deja de ser geométricamente válido cuando supera la mitad del lado más corto.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Esta calculadora comprueba la anchura, la altura y el radio propuesto antes de aplicar el efecto. Una solicitud válida devuelve el radio máximo permitido y una descripción clara de la máscara alfa con forma de rectángulo redondeado. Una solicitud inválida falla de inmediato, para que herramientas de diseño, scripts de exportación y sistemas de contenido descarten configuraciones imposibles antes del renderizado.

Valide el radio antes de procesar una imagen

Introduzca la anchura y la altura de la imagen como píxeles enteros positivos y, después, indique el radio de esquina deseado en píxeles. El validador identifica el lado más corto y lo divide entre dos para establecer el mayor radio posible sin que se crucen los arcos de esquinas opuestas. En una imagen de 1200 por 800, por ejemplo, el lado más corto mide 800 píxeles y el radio máximo válido es de 400 píxeles. Se acepta cualquier radio desde cero hasta 400, incluidos valores fraccionarios cuando el motor de diseño o renderizado admite geometría de subpíxel. Todo valor superior se rechaza con un error de entrada que indica el límite calculado. Esta comprobación resulta útil antes de llamar a un transformador de imágenes, pues separa una decisión geométrica económica de la decodificación, la carga o el renderizado del archivo. También aplica una única regla a formularios web y API, y evita que un cliente limite silenciosamente un valor mientras otro produce un error. La anchura y la altura deben ser enteros positivos porque representan dimensiones ráster reales; el radio debe ser un número finito no negativo.

Comprenda la máscara de rectángulo redondeado

Un resultado correcto describe una máscara alfa con la misma anchura y altura que la imagen de origen. La zona central permanece opaca. En cada esquina, un arco de cuarto de círculo con el radio solicitado define el límite: los píxeles situados dentro del rectángulo redondeado siguen visibles, mientras que los que quedan fuera de los cuatro arcos se vuelven transparentes al aplicar la máscara. La capacidad describe esta operación, pero no carga, decodifica ni modifica ningún archivo de imagen. Un radio de cero produce un rectángulo opaco normal, por lo que no se elimina ningún píxel de las esquinas. Con el radio máximo, los arcos se encuentran a lo largo de la dimensión más corta; por eso, una imagen cuadrada se convierte en un círculo y una imagen rectangular adopta una forma de cápsula. La respuesta repite las dimensiones aceptadas, el radio y el radio máximo calculado junto con una descripción comprensible de la máscara. Así, el resultado sirve para registros, mensajes de validación, especificaciones de diseño y código posterior que deba explicar el efecto antes de invocar un renderizador. No se presupone ningún método de interpolación, ya que el suavizado depende del motor que aplique finalmente la máscara.

Aplique una sola regla geométrica en diseño y automatización

Una validación coherente del radio evita diferencias sutiles entre maquetas, sitios web, aplicaciones móviles y trabajos de imágenes por lotes. Un sistema de diseño puede comprobar las especificaciones de avatares y tarjetas antes de publicar sus tokens. Un servicio multimedia puede rechazar una transformación inválida antes de asignar recursos de procesamiento. Una tienda puede confirmar que el redondeo elegido funcionará con todos los tamaños de miniatura generados. Como esta capacidad solo realiza cálculos deterministas y construye texto, las mismas entradas siempre devuelven el mismo resultado; no utiliza red, aleatoriedad, reloj, almacenamiento ni operaciones ocultas sobre imágenes. El cálculo conserva las dimensiones del lienzo original porque redondear esquinas cambia la visibilidad de los bordes, no el tamaño del lienzo. El radio máximo depende únicamente del lado más corto, de modo que rotar las dimensiones o intercambiar anchura y altura no altera el límite permitido. El precio de la API es $0.002 por solicitud y este mismo cálculo puro puede ejecutarse gratis en el navegador. Utilice la descripción devuelta como plan o registro de validación y pase después el radio validado al renderizador independiente que realizará la transformación de píxeles.

Comprobar la geometría de un avatar

Confirme que el radio de una imagen de perfil es válido y determine si un avatar cuadrado quedará completamente circular.

Proteger una API de transformación

Rechace ajustes de esquina imposibles antes de cargar, decodificar o renderizar la imagen de origen.

Validar tokens de diseño

Compare radios compartidos con cada tamaño de imagen y mantenga un comportamiento coherente en web, móvil y exportaciones.

¿Cuál es el radio de esquina máximo permitido?

Es la mitad de la dimensión más corta. En una imagen de 800 por 600, el radio máximo es de 300 píxeles.

¿Qué ocurre cuando el radio es demasiado grande?

La solicitud falla con un error de entrada inválida que incluye el radio máximo calculado a partir de las dimensiones.

¿Esta capacidad modifica el archivo de imagen?

No. Valida dimensiones y describe la máscara alfa; un renderizador independiente debe aplicarla a los píxeles.

¿Puede el radio ser cero o fraccionario?

Sí. Cero describe una máscara rectangular sin esquinas eliminadas y se acepta cualquier valor fraccionario finito dentro del límite.

¿Redondear las esquinas cambia las dimensiones del lienzo?

No. La máscara conserva la anchura y la altura del origen; solo vuelve transparentes los píxeles exteriores a los arcos.

¿Cuánto cuesta una solicitud API?

Cada solicitud API cuesta $0.002. El cálculo determinista también puede ejecutarse en el navegador sin 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/round-corners

¿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/round-corners \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1200,"height":800,"radius":64}'
{
  "width": 1200,
  "height": 800,
  "radius": 64
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.round_corners",
  "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 →