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 un cuarto, medio o tres cuartos de vuelta (90, 180 o 270 grados), así los píxeles quedan derechos en todas partes.
Esta tarea no está disponible ahora mismo, así que no se puede contratar. No se cobra nada por ella.
Cómo funciona y APIPor 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ó; por eso, fijar la rotación en los propios píxeles lo corrige de forma definitiva.
Qué hace el endpoint
Envía la imagen a /image/rotate con el cuarto de vuelta que necesita —90, 180 o 270 grados— 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.
Rotación en ángulo recto, sin pérdida
Las correcciones habituales son todas cuartos de vuelta: 90 o 270 grados ponen derecha una foto de lado, y 180 da vuelta un escaneo que salió al revés. Como son rotaciones en ángulo recto, los píxeles solo se reordenan —no se remuestrea ni se estima nada—, así que no hay pérdida de calidad y el único cambio es que el ancho y el alto se intercambian en un giro de 90 o 270. Rotar a un ángulo libre para enderezar un escaneo inclinado unos pocos grados no forma parte de este endpoint.
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
Normalización de cargas de lado
Una app para compartir fotos rota 90 grados las imágenes que los usuarios suben de lado hasta dejarlas derechas, así las miniaturas nunca se ven acostadas.
Corrección de escaneos al revés
Un sistema de gestión documental rota un lote de páginas que salieron al revés del escáner con un giro de 180 grados 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 girados 90 o 180 grados respecto a la vertical.
Preguntas frecuentes
¿La API para rotar imágenes puede corregir una foto de lado o al revés?
Sí. Indica el cuarto de vuelta a aplicar —90 o 270 grados para una foto de lado, 180 para una al revés— y rota los píxeles reales, 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?
No: la rotación es solo en ángulos rectos: 0, 90, 180 o 270 grados. Eso cubre fotos y escaneos de lado o al revés; enderezar un escaneo inclinado unos pocos grados no está soportado aquí.
¿Rotar imágenes es gratis?
La API es de pago: cada llamada se descuenta de su saldo prepago de ForHosting KIT: recargue desde $10.00 (no caduca), pague el precio publicado de cada solicitud, y una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens, 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?
No. La rotación en pasos de 90 grados solo reordena los píxeles existentes, así que no tiene pérdida; el único cambio es que el ancho y el alto se intercambian en un giro de 90 o 270.
¿Qué formatos puedo rotar?
El endpoint funciona con formatos raster estándar como JPG, PNG y WebP, y puede elegir el formato de salida.
¿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
Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. Esta capacidad está disponible actualmente mediante la API, no como herramienta interactiva en la Web.
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. |