# Redimensionar Imagen

Cambia el tamaño de una imagen por píxeles o por porcentaje, sin deformarla

- Página: https://herramient.as/redimensionar-imagen
- Categoría: Imagen
- Dónde se ejecuta: en el navegador, los datos no salen del dispositivo

Es una herramienta interactiva: se usa desde el navegador en https://herramient.as/redimensionar-imagen.

## Uso por API

También se puede usar por API REST, con una clave en la cabecera `Authorization: Bearer htas_...`. Referencia completa: https://herramient.as/api-docs.md

### `POST /api/v1/tools/images/resize`

Cambia el tamaño de una imagen sin deformarla

Al menos una de width o height. La imagen se mete dentro de esas medidas manteniendo la proporción y **sin agrandarla nunca**: si pides 2000 px de una imagen de 800, recibes 800, y las cabeceras X-Image-Width y X-Image-Height dicen qué tamaño salió de verdad. Responde con los bytes de la imagen y no almacena nada.

Consume 3 unidades de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `file` | file | sí | La imagen, como multipart/form-data. Máximo 25 MB |
| `width` | integer | no | Ancho máximo en píxeles, de 1 a 10000 (Ejemplo: `1080`) |
| `height` | integer | no | Alto máximo en píxeles, de 1 a 10000 (Ejemplo: `1080`) |
| `format` | string | no | Formato de salida. Por defecto jpeg (Ejemplo: `png`) |
| `quality` | integer | no | Calidad de 1 a 100. Por defecto 90 (Ejemplo: `90`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `(binario)` | string | Los bytes de la imagen. El Content-Type es image/<format> |

**Errores**

- `400`: Falta el fichero, no se indicó ni width ni height, o algún parámetro no es válido
- `422`: El fichero está dañado o no es una imagen que sepamos decodificar
- `503`: El servicio de procesamiento no está disponible. Reintenta según Retry-After

```bash
curl -X POST https://herramient.as/api/v1/tools/images/resize \
  -H "Authorization: Bearer htas_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"width":1080,"height":1080,"format":"png","quality":90}'
```

## Preguntas frecuentes

### ¿En qué se diferencia de comprimir una imagen?

En lo que le pides. Aquí das una medida concreta — "1080 píxeles de ancho" — porque te la ha pedido una web, un formulario o una plataforma. Al comprimir, lo que te importa es el peso del fichero y el tamaño es solo un medio. El motor es el mismo y las dos se pueden combinar: redimensiona aquí y comprime después, o ajusta el ancho máximo directamente en el compresor.

### ¿Qué es mantener la proporción y cuándo lo quito?

Con la casilla marcada, al escribir el ancho se calcula el alto solo, de forma que la imagen no se deforme. Quítala únicamente si necesitas una medida exacta en los dos lados y te da igual que la foto salga estirada o achatada. Para llegar a una medida exacta sin deformar, casi siempre es mejor recortar: ahí te sirve la herramienta de recortar para redes sociales.

### ¿Puedo agrandar una imagen pequeña?

Puedes, hasta el 200 %, pero no esperes milagros: ampliar no inventa detalle, solo estira los píxeles que ya había, y el resultado sale blando. Si necesitas una imagen más grande, lo que hay que buscar es el original en mejor resolución, no ampliar esta.

### ¿Mantiene la orientación de las fotos del móvil?

Sí. Las fotos verticales del móvil se guardan en realidad tumbadas, con una etiqueta que dice cómo hay que girarlas, y al procesarlas sin cuidado salen de lado. Nosotros aplicamos esa etiqueta antes de redimensionar, así que lo que descargas está derecho.

### ¿Hay un límite de tamaño?

Aceptamos ficheros de hasta 50 MB y resultados de hasta 12.000 píxeles de lado. Los dos topes están por la misma razón: más allá, los navegadores empiezan a devolver imágenes en blanco sin dar ningún error, y preferimos decírtelo a que te descargues un fichero vacío.

## Herramientas relacionadas

- [Comprimir Imagen](https://herramient.as/comprimir-imagen): Reduce el peso de tus fotos eligiendo la calidad, con el antes y el después a la vista
- [Recortar Imagen para Redes](https://herramient.as/recortar-imagen-redes-sociales): Recorta una foto a la medida exacta de Instagram, WhatsApp, LinkedIn o X
- [Imprimir Fotos en un A4](https://herramient.as/imprimir-fotos-a4): Coloca varias fotos en una hoja A4 al tamaño exacto, carnet incluido
- [Crear carrusel para Instagram](https://herramient.as/crear-carrusel-instagram): Monta un carrusel de hasta 20 diapositivas con fotos, titulares y datos, todas con el mismo estilo: defines la serie una vez y se aplica a todas. Se dibuja en tu navegador y te lo descargas en un ZIP numerado.