Developer API · REST · Made in Germany

Developer API.
ALT-Texte per API generieren.

Generiere SEO-optimierte, barrierefreie ALT-Texte für Produktbilder vollautomatisch – direkt aus deinem Shop, CMS, Marktplatz oder deiner eigenen App.

Shopify · WooCommerce · Magento · PrestaShop Bulk-Verarbeitung Multilingual
Base URL
app.autoalt.ai/api
Auth
Bearer Token
Format
multipart/form-data
Credits
1 Bold = 1 credit

Einführung

Mit der AutoAlt.ai Developer API generierst du automatisch SEO-optimierte ALT-Texte für Produktbilder per KI. Integriere die API in deine E-Commerce-Plattform, dein CMS, einen Marktplatz, eine Mobile-App oder einen eigenen Workflow – und verbessere Bild-Barrierefreiheit und Suchmaschinenoptimierung im großen Maßstab.

ALT-Texte für einzelne oder viele Bilder erzeugen
ALT-Texte für ganze Produktkataloge automatisieren
SEO & Barrierefreiheit (EAA / BFSG / WCAG) verbessern
Bulk-Bildverarbeitung & eigene Integrationen

Authentifizierung

Jede Anfrage wird über deinen persönlichen API-Key autorisiert. Übergib den Key im Authorization-Header als Bearer-Token. Deinen API-Key findest du in deinem AutoAlt.ai-Konto.

HeaderWert
AuthorizationBearer YOUR_API_KEY
Acceptapplication/json

Behandle deinen API-Key wie ein Passwort. Gib ihn niemals im Frontend/Client-Code preis – führe API-Calls serverseitig aus.

POST https://app.autoalt.ai/api/autoalt-generate-alt

Generate ALT Text

Erzeugt einen KI-generierten ALT-Text für ein Bild. Der Endpoint unterstützt Bild-URLs, Base64-Bilder, SEO-Keywords, eigene Prompts, Writing-Styles und mehrsprachige ALT-Text-Generierung.
Content-Type: multipart/form-data

Beispiel-Request (cURL)

curl --location 'https://app.autoalt.ai/api/autoalt-generate-alt' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json' \
  --form 'image_url="https://example.com/product-image.jpg"' \
  --form 'language="English"' \
  --form 'seo_keywords="ceramic wall tiles, glossy tiles"' \
  --form 'ai_writing_style="SEO-Optimized"' \
  --form 'website_domain="store.myshopify.com"'

Request-Parameter

ParameterTypPflichtBeschreibung
image_urlstringJaÖffentlich erreichbare Bild-URL
base64_imgstringOptionalBase64-kodiertes Bild. Erforderlich, wenn das Bild nicht öffentlich erreichbar oder per. .htaccess geschützt ist
languagestringOptionalSprache des ALT-Textes
ai_writing_stylestringOptionalKI-Schreibstil (siehe Writing Styles)
seo_keywordsstringOptionalSEO-Keywords, die berücksichtigt werden sollen
negative_keywordsstringOptionalKeywords, die vermieden werden sollen
customPromptFromUserstringOptionalIndividuelle KI-Anweisung / eigener Prompt
hardcoded_string_beginstringOptionalFester Text am Anfang des ALT-Textes
hardcoded_string_endstringOptionalFester Text am Ende des ALT-Textes
autoaltai_image_namestringOptionalBildnamen im ALT-Text verwenden – on / off
website_domainstringOptionalDomain der Website

E-Commerce-Felder

Diese optionalen Parameter liefern der KI zusätzliche Produktinformationen und sorgen für präzisere, SEO-freundlichere und produktbezogene ALT-Texte – besonders nützlich für Mode, Möbel, Elektronik und Fliesen.

ParameterBeschreibung
product_nameProdukttitel / Produktname für genauere ALT-Texte
product_brandsMarke oder Hersteller des Produkts
product_colorHauptfarbe des Produkts – verbessert visuelle & SEO-Genauigkeit

Warum diese Parameter nutzen?

Produktbezogene Daten helfen der KI, Folgendes zu erzeugen:

Genauere Produktbeschreibungen
Besser SEO-fokussierte ALT-Texte
Verbesserte Barrierefreiheit
Markenbewusste Bildbeschreibungen
Farbspezifische Produktidentifikation

Beispiel mit Produktdaten

curl --location 'https://app.autoalt.ai/api/autoalt-generate-alt' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --form 'image_url="https://example.com/product-image.jpg"' \
  --form 'product_name="Premium Ceramic Wall Tile"' \
  --form 'product_brands="AutoTiles"' \
  --form 'product_color="White"'
Beispiel-Output

„White premium ceramic wall tile by AutoTiles for modern bathroom interiors“

Writing Styles

Der Parameter ai_writing_style steuert Tonalität, Struktur und Schreibstil des generierten ALT-Textes – passend zu deiner Markenstimme, SEO-Strategie oder deinen Accessibility-Anforderungen.

Unterstützte Writing Styles

Writing StyleBeschreibung
SEO-OptimizedKeyword-rich for SEO improvement
NeutralClear, balanced, and objective
FriendlyWarm, approachable, and informal
ProfessionalPolished and business-appropriate
CasualRelaxed and conversational
WittyClever and playful tone
ConfidentBold and assertive writing
EmpatheticSensitive and understanding tone
InspiringMotivational and uplifting
TechnicalPrecise and jargon-friendly
MinimalistSimple and concise
LuxuryElegant and premium wording
YouthfulTrendy and modern style
QuirkyFun and creative language
Sales-OrientedPersuasive and conversion-focused
InformativeEducational and factual
FormalStructured and traditional
AuthoritativeExpert and trustworthy tone

Beispiel-Request (Writing Style)

curl --location 'https://app.autoalt.ai/api/autoalt-generate-alt' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --form 'image_url="https://example.com/product.jpg"' \
  --form 'ai_writing_style="SEO-Optimized"'

Output-Vergleich (gleiches Bild)

SEO-Optimized

Modern white ceramic wall tiles with glossy finish for bathroom and kitchen interiors

Minimalist

White glossy ceramic wall tiles

Luxury

Premium glossy white ceramic wall tiles designed for elegant modern interiors

POST https://app.autoalt.ai/api/autoalt-verify-api-key

Verify API Key

Prüft, ob ein AutoAlt.ai API-Key aktiv und gültig ist – bevor du eigentliche API-Anfragen stellst.

Dieser Endpoint ist nützlich für:

Plugin-Authentifizierung App-Integrationen Verbindungstests Konto-Verifizierung Ungültige Anfragen vermeiden

Request parameters

ParameterTypPflichtBeschreibung
apiKeystringJaDein AutoAlt.ai API-Key

Request (cURL)

curl --location --request POST \
  'https://app.autoalt.ai/api/autoalt-verify-api-key' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --form 'apiKey="YOUR_API_KEY"'

Response

gültig
{
  "is_verify": true
}
ungültig
{
  "is_verify": false
}

is_verify gibt true zurück, wenn der API-Key gültig ist – andernfalls false.

Response & Credits

Bei Erfolg liefert die API ein JSON-Objekt mit dem generierten ALT-Text, der Sprache und der Anzahl verbrauchter Credits. 1 Bild = 1 Credit – unabhängig von Format oder Anzahl der Ausgabesprachen.

200 · Erfolg
{
    "alt_text": "White glossy ceramic wall tiles for modern bathroom interior",
    "total_credit": 50,
    "credits": 36,
    "used_credits": 14,
    "asset_id": "deb9a028f5c7c64c0631393432393546e39c62cbafc92ce8",
    "filename": null,
    "imagename": null,
    "used_plan": "free",
}

Best Practices

Immer den korrekten Produktnamen übergeben
Bei Markenprodukten den Markennamen mitschicken
Genaue Produktfarbe für bessere visuelle Beschreibungen
Mit SEO keywords kombinieren für maximale Optimierung

Besonders empfohlen für Mode, Möbel, Elektronik und Fliesen-Produkte.

Bereit für die Integration?

Bereit für die Integration?