AltGen über die API in Ihre Upload-Pipeline Einbinden

Das Dashboard eignet sich gut für einmalige Batches, aber wenn sich Bilder ständig durch Ihr Produkt bewegen, wollen Sie keinen Menschen im Alt-Text-Prozess. Hier erfahren Sie, wie Sie AltGen direkt in Ihren eigenen Upload-Pfad einbinden.

Einen begrenzten API-Schlüssel holen

Erstellen Sie einen unter Settings → API Keys. Schlüssel sind pro Workspace begrenzt, können optional ablaufen und lassen sich widerrufen, ohne den Rest Ihrer Integration zu berühren.

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"]
  }'

Die Antwort enthält den primären Alt-Text sowie eine Übersetzung pro angeforderter Sprache:

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

Zwei Wege, Ergebnisse zu erhalten

Synchron — Endpunkt aufrufen und auf die Antwort warten. Einfach, aber nur für einzelne Bilder oder geringes Volumen sinnvoll.

Webhooks — für alles im großen Maßstab abonnieren Sie stattdessen Generierungs-Ereignisse. AltGen sendet eine Payload an Ihren Endpunkt, sobald ein Bild fertig verarbeitet ist, damit Ihr Upload-Handler nicht auf einen Batch von 500 Bildern warten muss.

Eine typische CMS-Integration

Ein Redakteur lädt ein Bild in Ihr CMS hoch.
Ihr Upload-Handler ruft POST /v1/images/generate mit der Bild-URL auf.
AltGen verarbeitet es und sendet nach Abschluss einen Webhook an Ihren Endpunkt.
Ihr Handler schreibt den zurückgegebenen Alt-Text direkt in das Metadatenfeld des Bildes.

Kein Dashboard, kein manueller Prüfschritt, kein Bild, das ohne Alt-Text ausgeliefert wird, weil jemand ein Feld vergessen hat.

Fehlgeschlagene Versuche wiederholen, ohne einen Batch zu überwachen

Wenn eine Generierung fehlschlägt, rufen Sie PATCH /v1/images/{id}/retry auf, statt alles neu einzureichen. Das ist derselbe Mechanismus, den die Bulk-Batches intern verwenden, nur freigelegt für Fälle, in denen Sie einzelne Bilder über die API verwalten.

Das ist die gesamte Angriffsfläche: ein Endpunkt zum Erzeugen, Auflisten, Aktualisieren und Wiederholen, plus Webhooks, falls Sie nicht pollen möchten. Vollständige Referenz in der API-Dokumentation.