Calidad de imagen
No toda subida rechazada es contenido inapropiado; muchas son simplemente fotos malas: fuera de foco, tomadas a oscuras o llenas de ruido de sensor. Este endpoint califica la calidad técnica de la imagen para detectar esas subidas antes de que un anuncio, perfil o galería salga a producción con una foto inutilizable.
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 silencioso que nadie marca a mano
Una foto de producto borrosa no viola ninguna política, así que pasa sin problemas la moderación de contenido —y aun así hunde la conversión, se ve poco profesional y genera un mensaje de soporte pidiendo una mejor imagen. Nadie quiere montar una revisión manual solo para el enfoque de una foto, y tampoco hay personal para revisar a simple vista la exposición y el ruido de cada subida. image.quality automatiza justo ese juicio, calificando el estado técnico de la imagen en lugar de lo que muestra.
Qué se mide
Envíe una imagen por POST a /image/quality y reciba una evaluación de su estado técnico —que cubre problemas como desenfoque, mala iluminación o ruido excesivo— para que su aplicación pueda rechazarla o pedir una nueva subida antes de que la foto llegue a un anuncio activo o a un perfil público. Usted define el umbral: un marketplace puede aceptar estándares más laxos que una tienda de impresión bajo demanda que necesita imágenes de origen genuinamente nítidas.
Por qué es distinto de las revisiones de contenido
La evaluación de calidad responde una pregunta diferente a la de moderación o clasificación: no 'qué es esta imagen' sino 'esta imagen es técnicamente utilizable'. Una foto perfectamente apropiada y perfectamente relevante puede reprobar aquí si está oscura y granulada, y una foto técnicamente impecable puede seguir necesitando moderación por lo que muestra —los dos controles se complementan, no se superponen, y por eso son endpoints separados que puede llamar juntos o por separado.
Construida para el ritmo de las subidas
Como las subidas de fotos se disparan de forma impredecible —un lanzamiento de producto, una campaña de marketing, una publicación viral— el endpoint encola de inmediato y devuelve un task_id enseguida en lugar de mantener una conexión abierta mientras califica la imagen. La evaluación llega después por webhook en cuanto está lista, o mediante un enlace firmado disponible por 24 horas, así los flujos de subida siguen respondiendo sin importar cuántas fotos lleguen a la vez.
Dónde encaja en un flujo
La mayoría de los equipos ejecutan image.quality como la primera compuerta sobre las subidas nuevas —antes del almacenamiento, antes de la moderación, antes de que llegue a cualquier página de cara al cliente— porque tiene poco sentido moderar o etiquetar una foto que de todas formas es inutilizable. Encadénela con image.moderate para tener un único punto de control combinado que rechace tanto lo inseguro como lo inutilizable, o con image.tag e image.classify una vez que la foto ya pasó el umbral de calidad. El precio es una pequeña tarifa base por solicitud más una tarifa por imagen, ambas publicadas, y una solicitud que falla tras tres reintentos automáticos nunca se cobra.
Qué puede hacer con ella
Anuncios en marketplaces y clasificados
Rechace fotos de producto borrosas o mal iluminadas al momento de subirlas, en vez de dejar que un anuncio de baja calidad dañe la confianza del comprador.
Fotos de perfil
Pida al usuario retomar una foto de perfil oscura o fuera de foco de inmediato, antes de que se muestre a nadie más.
Tiendas de impresión y merchandising
Exija un umbral mínimo de nitidez en el arte que suministran los clientes para que nada se imprima borroso e inutilizable.
Limpieza masiva de archivos
Escanee una fototeca existente para identificar y marcar imágenes técnicamente deficientes subidas antes de que existiera algún control.
Preguntas frecuentes
¿Qué revisa exactamente la API de calidad de imagen?
El estado técnico —problemas como desenfoque, mala iluminación y ruido excesivo— y no el tema o la idoneidad del contenido de la foto.
¿Evaluar la calidad de una imagen 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.
¿En qué se diferencia image.quality de image.moderate?
Calidad revisa si la foto es técnicamente utilizable —nítida, bien iluminada, con poco ruido; moderación revisa si su contenido es apropiado para publicarse. Son controles separados y complementarios.
¿Cómo se cobra la evaluación de calidad de imagen?
Una pequeña tarifa fija por solicitud más una tarifa por imagen, ambas publicadas en esta página, sin créditos ni tokens ocultos.
¿Puedo definir mi propio umbral de calidad?
Sí —la evaluación le da un puntaje de estado técnico que puede mapear a su propia lógica de aceptar, advertir o rechazar según el caso de uso.
¿Puedo escanear toda una fototeca existente por problemas de calidad?
Sí, cada imagen es su propia tarea asíncrona, así que una biblioteca completa puede revisarse igual que las subidas nuevas, solo que a mayor volumen.
¿Qué tan rápido llegan los resultados?
Un task_id se devuelve de inmediato, y la evaluación llega después por webhook firmado, o mediante un enlace firmado válido por 24 horas.
¿Qué pasa si falla una revisión de calidad?
Se reintenta automáticamente hasta tres veces; si sigue fallando recibe un error claro y no paga nada por esa solicitud.
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/quality \
-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/quality", {
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/quality",
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/quality", 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/quality", 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.quality",
"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. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |