Rotar una imagen
Una foto tomada de lado, un escaneo que salió al revés, un lote de cargas donde la mitad de los teléfonos registró la orientación distinto que la otra mitad: este endpoint lo corrige rotando la imagen al ángulo que indique, o leyendo los propios datos de orientación del archivo y corrigiéndolos de forma automática.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
Por qué las imágenes terminan mal orientadas
La mayoría de las cámaras de teléfono en realidad no rotan los píxeles cuando gira el teléfono para tomar la foto de lado; en cambio, escriben una marca de orientación en los metadatos EXIF de la imagen y esperan que quien la muestre lea esa marca y rote al desplegarla. Eso funciona bien en aplicaciones que respetan el EXIF, y falla en muchos flujos de trabajo, generadores de miniaturas y sistemas antiguos que lo ignoran, que es exactamente cómo una foto tomada de lado termina viéndose de lado en todas partes menos en el teléfono que la tomó.
Qué hace el endpoint
Envía la imagen a /image/rotate con un ángulo específico o con la instrucción de corregir automáticamente según la orientación EXIF, y devuelve una versión con los píxeles realmente rotados, así que la orientación queda fija y correcta sin importar si el siguiente sistema lee o no los metadatos. La solicitud devuelve un task_id de inmediato, la rotación ocurre de forma asíncrona, y el resultado llega mediante un webhook firmado o un enlace firmado válido por 24 horas.
Aquí la precisión importa
Rotar no es solo corregir fotos de lado; también sirve para enderezar un documento escaneado que entró unos grados torcido, o girar un diagrama 90 grados para que encaje en un diseño. Poder rotar a cualquier ángulo, no solo en pasos de 90, 180 o 270 grados, significa que un escaneo ligeramente inclinado se puede corregir hasta quedar nivelado, en vez de solo girarlo al cuarto de vuelta más cercano.
Cómo se integra en la automatización
Al ser una única llamada asíncrona, encaja justo después del paso de carga en cualquier flujo que reciba fotos de fuentes impredecibles: imágenes enviadas por usuarios, papeleo escaneado o capturas de cámaras. Las rotaciones fallidas reintentan automáticamente hasta tres veces antes de devolver un error claro, y una tarea que nunca se completa nunca se cobra, así que un archivo malformado no genera ningún costo.
Quién necesita esto
Los sistemas de gestión documental que corrigen páginas escaneadas, las aplicaciones para compartir fotos que normalizan las cargas de usuarios, y las plataformas de comercio electrónico que aseguran que las fotos de producto se muestren en posición correcta sin importar cómo las registró el teléfono del vendedor, todos dependen exactamente de este tipo de corrección.
Qué puede hacer con ella
Corrección automática por EXIF al subir
Una app para compartir fotos rota automáticamente cada imagen cargada según su marca de orientación EXIF, así las miniaturas nunca se ven de lado.
Enderezado de documentos escaneados
Un sistema de gestión documental rota escaneos torcidos a un ángulo preciso para alinear el texto horizontalmente antes de aplicar OCR.
Normalización de fotos de producto
Un marketplace en línea rota las fotos de producto enviadas por los vendedores a una orientación vertical consistente antes de publicar la ficha.
Corrección por lotes en archivos antiguos
Una organización que digitaliza un archivo fotográfico antiguo rota un lote de escaneos que entraron al escáner en ángulos inconsistentes.
Preguntas frecuentes
¿La API para rotar imágenes puede corregir la orientación automáticamente?
Sí, puede leer los datos de orientación EXIF de la imagen y rotar los píxeles para que coincidan, así el archivo se muestra correctamente en todas partes, no solo en visores que respetan el EXIF.
¿Puedo rotar a un ángulo personalizado, no solo 90 grados?
Sí, puede especificar cualquier ángulo, lo cual es útil para enderezar un escaneo ligeramente torcido en vez de rotar solo en cuartos de vuelta.
¿Rotar imágenes es gratis?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cuál es el costo por imagen?
$0.002 por solicitud más $0.005 por imagen, y nunca se cobra una tarea que falla.
¿La rotación es síncrona?
No, es asíncrona. Recibe un task_id de inmediato, y la imagen rotada llega mediante un webhook firmado o un enlace firmado válido por 24 horas.
¿Rotar una imagen pierde calidad?
La rotación en incrementos de 90 grados no tiene pérdida en los datos de píxeles; los ángulos arbitrarios implican algo de remuestreo en los bordes, lo cual es normal en cualquier rotación no ortogonal.
¿Qué formatos puedo rotar?
El endpoint funciona con formatos raster estándar como JPG, PNG, BMP, TIFF y WebP.
¿Puedo rotar muchas imágenes en un solo flujo de trabajo?
Envía una imagen por solicitud, pero puede lanzar muchas solicitudes en paralelo o programarlo como un proceso por lotes para grandes volúmenes.
Para desarrolladores — acceso por API
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.
Endpoint de API
¿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, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/image/rotate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"image":"https://ejemplo.com/imagen.jpg"}'const res = await fetch("https://api.kit.forhosting.com/image/rotate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"image": "https://ejemplo.com/imagen.jpg"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/rotate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"image": "https://ejemplo.com/imagen.jpg"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/rotate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"image":"https://ejemplo.com/imagen.jpg"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/rotate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"image": "https://ejemplo.com/imagen.jpg"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.rotate",
"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.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 15 |
max_megapixels | 12 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |