Collegare AltGen alla Tua Pipeline di Upload con l’API

La dashboard va bene per batch occasionali, ma se le immagini si muovono costantemente nel tuo prodotto, non vuoi un umano nel loop per il testo alternativo. Ecco come collegare AltGen direttamente al tuo percorso di upload.

Ottieni una chiave API con permessi limitati

Creane una da Settings → API Keys. Le chiavi sono limitate per workspace, possono scadere facoltativamente e possono essere revocate senza toccare il resto della tua integrazione.

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 risposta torna con il testo alternativo principale più una traduzione per ogni lingua richiesta:

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

Due modi per usare i risultati

Sincrono — chiama l’endpoint e attendi la risposta. Semplice, ma ha senso solo per immagini singole o volumi bassi.

Webhook — per tutto ciò che è su larga scala, iscriviti invece agli eventi di generazione. AltGen invia un payload al tuo endpoint non appena un’immagine finisce di essere elaborata, così il tuo gestore di upload non resta in attesa di un batch di 500 immagini.

Un’integrazione CMS tipica

1. L’editor carica un’immagine nel tuo CMS.
2. Il tuo gestore di upload chiama POST /v1/images/generate con l’URL dell’immagine.
3. AltGen la elabora e attiva un webhook verso il tuo endpoint al completamento.
4. Il tuo gestore scrive il testo alternativo restituito direttamente nel campo metadati dell’immagine.

Nessuna dashboard, nessun passaggio di revisione manuale, nessuna immagine che viene pubblicata senza testo alternativo perché qualcuno ha dimenticato di compilare un campo.

Ritentare i fallimenti senza monitorare un batch

Se una generazione fallisce, chiama PATCH /v1/images/{id}/retry invece di inviare di nuovo tutto. È lo stesso meccanismo che i batch massivi usano internamente, semplicemente esposto per i casi in cui gestisci immagini singole tramite l’API.

Questa è tutta la superficie: un endpoint per generare, elencare, aggiornare e ritentare, più i webhook se non vuoi fare polling. Il riferimento completo è nella documentazione API.