Volver al inicio
altgen.
Todos los artículos
Todos los artículos

Cómo Conectar AltGen a Tu Pipeline de Subida con la API

El panel está bien para lotes puntuales, pero si las imágenes se mueven constantemente por tu producto, no quieres un humano en el medio para el texto alternativo. Así se conecta AltGen directamente a tu propio flujo de subida.

Consigue una clave de API con alcance limitado

Crea una desde Settings → API Keys. Las claves tienen alcance por workspace, pueden expirar opcionalmente, y se pueden revocar sin tocar el resto de tu integración.

curl -X POST https://api.altgen.io/v1/images/generate \
  -H "Authorization: Bearer $ALTGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://cdn.yourstore.com/sneaker.jpg",
    "preset": "ecommerce",
    "style": "concise",
    "languages": ["en", "de", "tr"]
  }'

La respuesta vuelve con el texto alternativo principal más una traducción por cada idioma solicitado:

{
  "altText": "Burgundy low-top sneaker with a white sole, floating on a yellow background",
  "translations": { "de": "…", "tr": "…" },
  "status": "completed",
  "creditsCost": 1
}

Dos formas de consumir los resultados

Síncrona — llama al endpoint y espera la respuesta. Simple, pero solo tiene sentido para imágenes individuales o volumen bajo.

Webhooks — para cualquier cosa a escala, suscríbete a los eventos de generación en su lugar. AltGen envía un payload a tu endpoint en cuanto una imagen termina de procesarse, así tu manejador de subidas no se queda esperando un lote de 500 imágenes.

Una integración típica con un CMS

  1. El editor sube una imagen a tu CMS.
  2. Tu manejador de subidas llama a POST /v1/images/generate con la URL de la imagen.
  3. AltGen la procesa y dispara un webhook a tu endpoint al terminar.
  4. Tu manejador escribe el texto alternativo devuelto directamente en el campo de metadatos de la imagen.

Sin panel, sin paso de revisión manual, sin imágenes que se publican sin texto alternativo porque alguien olvidó rellenar un campo.

Reintentar fallos sin vigilar un lote

Si una generación falla, llama a PATCH /v1/images/{id}/retry en lugar de volver a enviar todo. Es el mismo mecanismo que los lotes masivos usan internamente, solo expuesto para los casos en los que gestionas imágenes individuales a través de la API.

Esa es toda la superficie: un endpoint para generar, listar, actualizar y reintentar, más webhooks si no quieres hacer polling. La referencia completa está en la documentación de la API.