Connecter AltGen à Votre Pipeline d’Upload via l’API

Le tableau de bord convient bien pour des lots ponctuels, mais si les images circulent constamment dans votre produit, vous ne voulez pas d’humain dans la boucle pour le texte alternatif. Voici comment brancher AltGen directement dans votre propre flux d’upload.

Obtenez une clé API limitée

Créez-en une depuis Settings → API Keys. Les clés sont limitées par workspace, peuvent optionnellement expirer, et peuvent être révoquées sans toucher au reste de votre intégration.

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 réponse revient avec le texte alternatif principal plus une traduction par langue demandée :

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

Deux façons de récupérer les résultats

Synchrone — appelez l’endpoint et attendez la réponse. Simple, mais n’a de sens que pour des images uniques ou un faible volume.

Webhooks — pour tout ce qui est à l’échelle, abonnez-vous plutôt aux événements de génération. AltGen envoie une charge utile à votre endpoint dès qu’une image a fini d’être traitée, pour que votre gestionnaire d’upload n’attende pas un lot de 500 images.

Une intégration CMS typique

1. Un éditeur téléverse une image dans votre CMS.
2. Votre gestionnaire d’upload appelle POST /v1/images/generate avec l’URL de l’image.
3. AltGen la traite et déclenche un webhook vers votre endpoint une fois terminé.
4. Votre gestionnaire écrit le texte alternatif retourné directement dans le champ de métadonnées de l’image.

Pas de tableau de bord, pas d’étape de révision manuelle, pas d’image publiée sans texte alternatif parce que quelqu’un a oublié de remplir un champ.

Relancer les échecs sans surveiller un lot

Si une génération échoue, appelez PATCH /v1/images/{id}/retry plutôt que de tout renvoyer. C’est le même mécanisme que les lots massifs utilisent en interne, simplement exposé pour les cas où vous gérez des images individuelles via l’API.

Voilà toute la surface d’utilisation : un endpoint pour générer, lister, mettre à jour et relancer, plus des webhooks si vous ne voulez pas faire de polling. La référence complète est dans la documentation de l’API.