Brillo y contraste
Una foto de producto a contraluz o una imagen tomada en una bodega mal iluminada no necesita un retoque completo, necesita que su brillo y contraste vuelvan a un rango razonable. Este endpoint recibe valores numéricos de ajuste y los aplica a cualquier imagen compatible en una sola llamada, convirtiendo la corrección de exposición en un paso repetible en vez de mover un control deslizante a mano mil veces.
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.
El vacío que resuelve
La captura masiva de fotos, ya sea de agentes de campo, escáneres de bodega o cargas de usuarios, produce una exposición muy inconsistente porque las condiciones de luz nunca están controladas. Un editor humano puede corregir una imagen en segundos, pero nadie quiere abrir Photoshop para la foto número diez mil de la semana, y ese es exactamente el vacío que cierra este endpoint.
Brillo y contraste como controles independientes
El brillo desplaza uniformemente el valor de cada píxel hacia arriba o hacia abajo, aclarando u oscureciendo toda la imagen, mientras que el contraste amplía o comprime el rango entre los píxeles más oscuros y más claros, haciendo las sombras más profundas y las luces más marcadas sin alterar la exposición promedio. Enviar ambos valores por separado, en lugar de un único número de 'corrección automática', es lo que permite corregir un problema específico y conocido, como una foto lavada por el flash, en vez de aplicar una mejora genérica al azar.
Cómo funciona la llamada
Envíe la imagen junto con los valores de brillo y contraste a POST /image/brightness-contrast, y la respuesta devuelve un task_id de inmediato porque el ajuste corre de forma asíncrona en segundo plano. La imagen corregida se entrega mediante un webhook firmado, ideal para flujos que necesitan reaccionar automáticamente, o un enlace firmado válido por 24 horas para recuperación manual.
Un control tan antiguo como los sensores de imagen
El ajuste de brillo y contraste antecede por completo a la fotografía digital: los diales de compensación de exposición de las cámaras y las técnicas de subexposición y sobreexposición en cuarto oscuro resolvían el mismo problema sobre película décadas antes de que existieran los píxeles. La matemática cambió, del tiempo de exposición química al remapeo numérico de píxeles, pero la necesidad de fondo, hacer legible una captura mal iluminada, nunca desapareció.
Pensado para flujos repetibles
Cada llamada se cobra solo cuando la corrección se completa con éxito; el sistema reintenta automáticamente hasta tres veces antes de mostrar un error claro, así que una falla pasajera nunca se convierte en un cobro sin resultado. No hay nivel gratuito ni periodo de prueba que se interponga; saldo prepago ejecuta el trabajo de inmediato, y una respuesta 402 lo indica con claridad cuando no es así, manteniendo la cola predecible para automatización de alto volumen.
Qué puede hacer con ella
Estandarización de fotos de campo
Una app de servicio técnico corrige automáticamente el brillo y el contraste de las fotos enviadas por técnicos, ya que la luz en sótanos, áticos y sitios exteriores varía enormemente.
Limpieza de fichas de producto
Un marketplace aumenta el contraste en lote de las fotos de vendedores tomadas con poca luz, para que las publicaciones cumplan un estándar visual mínimo sin revisión manual.
Corrección de legibilidad en documentos
Un flujo de digitalización sube el brillo de páginas capturadas con subexposición antes de ejecutar OCR, mejorando el reconocimiento de texto sin un paso manual adicional.
Preparación de restauración de archivos
Un proyecto de digitalización aplica una corrección de contraste consistente sobre un lote de fotografías escaneadas y descoloridas antes de catalogarlas.
Preguntas frecuentes
¿Cómo funciona la api de brillo y contraste?
Se envía una imagen con valores numéricos de brillo y contraste a POST /image/brightness-contrast, y el archivo corregido se devuelve de forma asíncrona por webhook o mediante un enlace firmado válido por 24 horas.
¿Es gratuita la api para ajustar brillo de imagen?
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 ajustar el brillo de una imagen?
Cada llamada cuesta $0.002 por solicitud más $0.005 por imagen, y solo se cobra cuando el ajuste se completa con éxito.
¿Puedo ajustar brillo y contraste de forma independiente?
Sí, son parámetros numéricos separados, así que puede ajustar uno, el otro, o ambos en la misma llamada según la corrección que necesite.
¿Qué pasa si el ajuste falla?
Nunca se cobra una tarea fallida. El sistema reintenta automáticamente hasta tres veces antes de devolver un error claro y accionable.
¿Puede corregir fotos muy subexpuestas o sobreexpuestas?
Puede corregir problemas de exposición moderados de forma efectiva; las imágenes extremadamente subexpuestas o quemadas tienen menos detalle recuperable, así que el resultado depende de cuánta información conservó la captura original.
¿Hay un límite de imágenes que puedo procesar a la vez?
Cada imagen se envía como una llamada asíncrona independiente, así que puede procesar lotes grandes lanzando muchas llamadas en paralelo en lugar de un límite fijo de imágenes por solicitud.
¿Cuánto tiempo está disponible el resultado para descargar?
El enlace firmado es válido por 24 horas después de completarse la tarea, y los archivos se eliminan al terminar la ventana de retención, sin usarse nunca para entrenamiento.
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/brightness-contrast \
-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/brightness-contrast", {
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/brightness-contrast",
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/brightness-contrast", 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/brightness-contrast", 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.brightness_contrast",
"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. |