ForHosting KIT · Imágenes

Voltear una imagen

A veces una imagen simplemente necesita mirar hacia el otro lado: una foto de producto tomada desde el ángulo equivocado, un negativo escaneado que se lee al revés, un elemento de diseño que necesita reflejar a su par. Este endpoint voltea la imagen en horizontal o en vertical y devuelve la versión reflejada, sin modificar nada más de ella.

● EstablePor solicitud + por imagen$0.002
Úselo desde WebAPIEmailApp prontoTelegram pronto

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.

Voltear contra rotar, y por qué la diferencia importa

Es fácil confundir voltear con rotar, pero resuelven problemas distintos. Rotar gira una imagen alrededor de un punto, útil para corregir una orientación de lado; voltear la refleja a través de un eje, que es lo que necesita cuando el contenido mismo está invertido, como texto leído desde el reverso de una página escaneada, un logotipo que necesita una contraparte reflejada para un diseño simétrico, o una foto donde el sujeto mira hacia el lado equivocado para el diseño en el que se inserta.

Cómo funciona la llamada

Envía la imagen a /image/flip y especifica horizontal o vertical, y recibe el archivo reflejado. La solicitud devuelve un task_id de inmediato, el volteo en sí corre de forma asíncrona, y obtiene el resultado mediante un webhook firmado o un enlace firmado que permanece válido por 24 horas, el mismo patrón de entrega en todas las tareas del sistema, así no tiene que tratar este endpoint como un caso especial en su integración.

Dónde se usa voltear en la práctica

Aparece más seguido de lo que la gente espera: fotografía de producto donde un zapato que mira a la izquierda necesita una contraparte que mire a la derecha para una publicación pareada, diseños de imprenta donde una imagen necesita reflejarse para un desplegable o una impresión a doble cara, negativos de película escaneados que salieron al revés, y sistemas de diseño que generan conjuntos de íconos simétricos a partir de un solo activo fuente. En cada caso, la alternativa sería volver a fotografiar o volver a dibujar el activo, cuando un volteo lo resuelve en una sola llamada.

Cómo encaja en un flujo más grande

Al ser un POST único y predecible, se combina sin problemas con otras tareas dentro de un flujo de trabajo: voltear, luego rotar, luego convertir de formato, cada uno como su propio paso asíncrono con su propio task_id. Un volteo fallido reintenta automáticamente hasta tres veces antes de devolver un error claro, y nunca se cobra una tarea que no se completa, algo que importa cuando un flujo corre sin supervisión sobre un lote de archivos fuente impredecibles.

A quién le sirve esto

Los equipos de diseño que construyen pares de activos reflejados, los catálogos de comercio electrónico que estandarizan la orientación de sus productos, y los proyectos de archivo que corrigen negativos escaneados usan el volteo como un ajuste pequeño y preciso, en vez de recurrir a un editor de imágenes completo.

Pares de producto reflejados

Una tienda de calzado genera la imagen de un zapato derecho reflejando la foto de un zapato izquierdo, en lugar de fotografiar ambos ángulos por separado.

Corrección de negativos escaneados

Un proyecto de digitalización de archivo voltea negativos de película escaneados que salieron invertidos, restaurando la orientación correcta de izquierda a derecha.

Generación de íconos simétricos

Un sistema de diseño crea la contraparte reflejada de un ícono direccional, como una flecha o un chevron, a partir de un único SVG fuente renderizado como PNG.

Diseño de desplegables para impresión

Una imprenta voltea una imagen en vertical para que coincida con la orientación invertida que necesita uno de los paneles de un folleto plegado.

¿Cuál es la diferencia entre voltear y rotar una imagen?

Voltear refleja una imagen sobre un eje horizontal o vertical, invirtiendo su contenido, mientras que rotar gira toda la imagen alrededor de un punto sin reflejarla.

¿Puedo voltear en horizontal y en vertical a la vez?

Sí, especifica la dirección en la solicitud; para voltear en ambos ejes, envía dos solicitudes o una después de la otra en su flujo de trabajo.

¿Voltear 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ánto cuesta voltear una imagen?

$0.002 por solicitud más $0.005 por imagen, y las tareas fallidas nunca se cobran.

¿El volteo se aplica de forma instantánea?

No, se procesa de forma asíncrona. Recibe un task_id de inmediato, y la imagen volteada llega mediante un webhook firmado o un enlace firmado válido por 24 horas.

¿Voltear afecta la calidad de la imagen?

No, un volteo horizontal o vertical solo reordena píxeles sin remuestreo, así que no hay pérdida de calidad.

¿Qué formatos de imagen admite la API para voltear?

Funciona con formatos raster estándar, incluyendo JPG, PNG, BMP, TIFF y WebP.

¿Qué pasa si envío un archivo dañado?

La tarea reintenta automáticamente hasta tres veces, y si aun así no se puede procesar, recibe un error claro sin ningún cobro.

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/flip

¿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.

curl -X POST https://api.kit.forhosting.com/image/flip \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image":"https://ejemplo.com/imagen.jpg"}'
{
  "image": "https://ejemplo.com/imagen.jpg"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.flip",
  "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
Por imagen$0.005

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 →