Generar texto alternativo
Un catálogo de tres mil productos sin texto alternativo es invisible tanto para los lectores de pantalla como para la búsqueda de imágenes. La API para generar texto alternativo analiza cada imagen y escribe una descripción concisa en lenguaje natural, pensada para servir a ambos propósitos a la vez: accesibilidad real para quienes usan tecnología de asistencia, y una señal genuina y relevante para los motores de búsqueda que no pueden ver píxeles. Envía una imagen y recibe una descripción lista para el atributo alt.
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.
Una sola etiqueta, dos públicos
El atributo alt se incluyó en HTML desde el principio como respaldo para cuando una imagen no cargaba, pero se convirtió en la forma principal en que los lectores de pantalla transmiten contenido visual a personas ciegas o con baja visión, y más tarde en una señal genuina para la búsqueda de imágenes. Esos dos públicos, la tecnología de asistencia y los rastreadores de búsqueda, quieren lo mismo: una oración corta y precisa que describa lo que realmente hay en la imagen, no una lista de palabras clave forzadas. Este endpoint escribe pensando en ambos a la vez, porque un buen texto alternativo siempre ha servido a los dos.
Qué cubre la descripción
Envía una imagen por POST a /image/describe y la tarea devuelve una descripción en lenguaje sencillo que identifica el sujeto principal, los detalles visibles relevantes y el contexto, redactada como una oración completa y natural en lugar de un fragmento. Está pensada para leerse como lo haría una persona describiendo la imagen en voz alta a alguien que no puede verla: suficientemente específica para ser útil, suficientemente breve para caber en un atributo alt.
Dónde lo usan los equipos
El motivo más común es un rezago acumulado: un catálogo de comercio electrónico migrado de una plataforma que nunca capturó texto alternativo, una biblioteca de medios con años de subidas sin ningún campo de descripción lleno, un CMS que dejó el texto alternativo como opcional y nadie lo completó. Como la tarea corre de forma asíncrona, procesa ese rezago en lotes sin ocupar un hilo de solicitud, entregando resultados por webhook conforme cada imagen termina, o mediante un enlace firmado para un script que prefiera consultarlos en su propio momento.
Un requisito de accesibilidad, no un extra
Las guías de accesibilidad exigen texto alternativo significativo desde hace décadas, y cada vez más se trata como un requisito básico y no como una meta aspiracional. Generarlo de forma automática no reemplaza la revisión humana de imágenes genuinamente importantes (un banner principal o un gráfico con datos reales siguen mereciendo una mirada humana), pero cierra la brecha en los miles de imágenes rutinarias que de otro modo quedarían sin describir.
Un precio pensado para trabajo a escala de catálogo
El costo combina una tarifa fija pequeña por solicitud con un cargo por imagen, así que describir una sola imagen destacada o procesar diez mil fotos de producto por el mismo endpoint escala de forma honesta según el trabajo realizado. Una descripción fallida se reintenta automáticamente hasta tres veces y nunca se cobra si sigue sin completarse, así que procesar un rezago completo solo te cuesta por las descripciones que realmente se entregan.
Qué puede hacer con ella
Rezago de texto alternativo en un catálogo de comercio electrónico
Una tienda en línea con miles de fotos de producto sin texto alternativo procesa todo su catálogo de una vez durante la noche para cerrar una brecha de accesibilidad y SEO.
Flujo de publicación en un CMS
Una plataforma de publicación genera automáticamente un borrador de texto alternativo en el momento en que un editor sube una imagen, ahorrando un paso manual en cada artículo.
Limpieza de una biblioteca de medios heredada
Una empresa que migra una biblioteca de medios de una década de antigüedad usa el endpoint para generar las descripciones faltantes de assets anteriores a cualquier exigencia de texto alternativo.
Remediación tras una auditoría de accesibilidad
Un equipo que responde a un hallazgo de auditoría de accesibilidad genera texto alternativo para cada imagen señalada como parte de un proceso documentado de remediación.
Preguntas frecuentes
¿Cómo redacta las descripciones la API para generar texto alternativo?
Analiza el contenido visible de cada imagen y produce una oración concisa en lenguaje natural que describe el sujeto principal y los detalles relevantes, lista para usarse directamente en un atributo alt.
¿El texto alternativo generado realmente ayuda al SEO?
Describe lo que hay genuinamente en la imagen con lenguaje natural en vez de saturarla de palabras clave, que es justo lo que premian los motores de búsqueda y exigen las guías de accesibilidad; ambos objetivos coinciden en vez de chocar.
¿Puede procesar un catálogo grande de productos en lote?
Sí, cada imagen es una solicitud y la tarea es asíncrona, así que un script puede enviar miles de imágenes y recolectar resultados por webhook conforme cada una termina, sin dejar nada bloqueado.
¿Esto reemplaza a una persona escribiendo texto alternativo para imágenes importantes?
Para imágenes de alto impacto, como gráficos con datos o banners clave de marketing, sigue valiendo la pena una revisión humana; el endpoint está pensado para cubrir con eficiencia el gran volumen de imágenes rutinarias que de otro modo quedarían sin describir.
¿La API para generar texto alternativo es gratuita?
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 tarda en llegar el resultado?
La tarea devuelve un task_id de inmediato y procesa de forma asíncrona; la descripción llega por webhook firmado, o puede obtenerla desde un enlace firmado válido por 24 horas.
¿Qué formatos de imagen admite?
Se admiten imágenes en JPEG, PNG y WebP como entrada para la generación de descripciones.
¿Qué pasa si falla la generación de una descripción?
La tarea reintenta automáticamente hasta tres veces antes de devolver un error claro, y una solicitud fallida nunca se cobra.
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/describe \
-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/describe", {
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/describe",
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/describe", 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/describe", 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.describe",
"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. |