Ajustar saturación
La intensidad del color es lo que hace que una foto de comida se vea apetitosa o que una foto de producto se vea apagada, y rara vez sale bien directamente del sensor de la cámara bajo luz mixta. Este endpoint recibe un valor de saturación y cualquier imagen compatible, y sube o baja la intensidad del color en una sola llamada, para que todo un catálogo mantenga el mismo impacto visual sin que un diseñador toque cada archivo.
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 problema del color inconsistente
Dos fotos del mismo producto tomadas minutos aparte bajo una luz ligeramente distinta pueden verse notablemente diferentes en cuán vivos se leen sus colores, y en un catálogo de miles esa inconsistencia se nota incluso para un comprador casual. Ajustar la saturación imagen por imagen a mano no escala, y aplicar un mismo filtro plano a toda una carpeta suele sobresaturar las imágenes que ya estaban bien.
Qué cambia realmente la saturación
La saturación controla qué tan intenso o qué tan apagado se ve un color sin tocar su brillo ni su tono, así que un rojo brillante sigue igual de brillante ya sea que se lleve hacia lo vívido o hacia el gris. Esa distinción importa porque permite que este endpoint haga que los colores resalten o se desvanezcan hacia lo monocromático sin oscurecer la imagen ni alterar su balance de color por accidente, algo que un ajuste más tosco suele provocar como efecto secundario.
Cómo hacer la llamada
Envíe la imagen y un valor numérico de saturación a POST /image/saturation, y recibirá un task_id de inmediato porque el trabajo se procesa de forma asíncrona en la cola. El resultado llega mediante un webhook firmado, el camino confiable para flujos automatizados, o un enlace firmado válido por 24 horas cuando alguien solo necesita descargar el archivo manualmente.
Un concepto tomado de la teoría del color
La saturación como eje formal del color, distinto del tono y del brillo, proviene de modelos de color desarrollados para pintores e imprentas mucho antes de que existiera el procesamiento digital de imágenes, y es la misma lógica que permite a un diseñador describir 'una versión más apagada de este azul exacto' sin cambiar de qué azul se trata. Las herramientas digitales solo hicieron ese mismo ajuste instantáneo y preciso en vez de requerir una mezcla física de pigmento o tinta.
Confiable a gran escala
Un trabajo de saturación fallido no cuesta nada; la plataforma reintenta automáticamente hasta tres veces y solo reporta un error cuando esos intentos se agotan, así que los flujos automatizados no pierden imágenes en silencio ni pagan por nada. No hay nivel gratuito ni lista de espera de prueba que retrase nada; saldo prepago arranca el trabajo de inmediato, y una respuesta 402 clara es lo único que se interpone cuando no es así.
Qué puede hacer con ella
Fotografía de comida y estilo de vida
Una app de entregas aumenta ligeramente la saturación de las fotos de restaurantes en lote para que los platillos se vean consistentemente apetitosos entre miles de cargas de proveedores.
Consistencia de color en catálogos
Una tienda de moda normaliza la saturación entre fotos de producto tomadas en distintos días y montajes de luz para que todo el catálogo se lea como una sola sesión coherente.
Control del tono editorial
Una plataforma de publicaciones desatura levemente fotos de archivo para darles un tono más calmado y editorial que encaje con la identidad visual de una sección específica.
Limpieza de contenido generado por usuarios
Una red social ajusta automáticamente la saturación de fotos planas y apagadas subidas por usuarios para hacerlas más atractivas visualmente antes de mostrarlas en un feed público.
Preguntas frecuentes
¿Qué cambia la api de saturación de imagen?
Ajusta qué tan intensos o apagados se ven los colores de una imagen, de forma independiente al brillo y al tono, mediante un valor numérico enviado a POST /image/saturation.
¿Es gratuita la api de saturación 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 la saturación?
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 desaturar una imagen hasta dejarla en blanco y negro?
Sí, llevar el valor de saturación lo suficientemente bajo acerca la imagen a lo monocromático, aunque para una conversión dedicada a escala de grises nuestro endpoint de escala de grises es la herramienta más precisa.
¿Qué pasa si falla una solicitud de saturación?
No se cobra nada. El sistema reintenta automáticamente hasta tres veces antes de devolver un error claro.
¿Puedo procesar todo un catálogo de producto a la vez?
Sí, cada imagen se envía como una llamada asíncrona independiente, así que puede lanzar lotes grandes en paralelo en lugar de procesarlos uno por uno.
¿Ajustar la saturación afecta el brillo?
No, la saturación es un eje distinto del brillo, así que un ajuste bien implementado cambia la intensidad del color sin oscurecer ni aclarar la imagen.
¿Cómo recibo la imagen ajustada?
Mediante un webhook firmado para flujos automatizados, o un enlace firmado válido por 24 horas para descarga manual, después del cual el archivo se elimina.
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/saturation \
-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/saturation", {
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/saturation",
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/saturation", 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/saturation", 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.saturation",
"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. |