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.
app.autoalt.ai/api
Bearer Token
multipart/form-data
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.
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.
| Header | Wert |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Accept | application/json |
Behandle deinen API-Key wie ein Passwort. Gib ihn niemals im Frontend/Client-Code preis – führe API-Calls serverseitig aus.
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
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| image_url | string | Ja | Öffentlich erreichbare Bild-URL |
| base64_img | string | Optional | Base64-kodiertes Bild. Erforderlich, wenn das Bild nicht öffentlich erreichbar oder per. .htaccess geschützt ist |
| language | string | Optional | Sprache des ALT-Textes |
| ai_writing_style | string | Optional | KI-Schreibstil (siehe Writing Styles) |
| seo_keywords | string | Optional | SEO-Keywords, die berücksichtigt werden sollen |
| negative_keywords | string | Optional | Keywords, die vermieden werden sollen |
| customPromptFromUser | string | Optional | Individuelle KI-Anweisung / eigener Prompt |
| hardcoded_string_begin | string | Optional | Fester Text am Anfang des ALT-Textes |
| hardcoded_string_end | string | Optional | Fester Text am Ende des ALT-Textes |
| autoaltai_image_name | string | Optional | Bildnamen im ALT-Text verwenden – on / off |
| website_domain | string | Optional | Domain 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.
| Parameter | Beschreibung |
|---|---|
| product_name | Produkttitel / Produktname für genauere ALT-Texte |
| product_brands | Marke oder Hersteller des Produkts |
| product_color | Hauptfarbe des Produkts – verbessert visuelle & SEO-Genauigkeit |
Warum diese Parameter nutzen?
Produktbezogene Daten helfen der KI, Folgendes zu erzeugen:
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"' „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 Style | Beschreibung |
|---|---|
| SEO-Optimized | Keyword-rich for SEO improvement |
| Neutral | Clear, balanced, and objective |
| Friendly | Warm, approachable, and informal |
| Professional | Polished and business-appropriate |
| Casual | Relaxed and conversational |
| Witty | Clever and playful tone |
| Confident | Bold and assertive writing |
| Empathetic | Sensitive and understanding tone |
| Inspiring | Motivational and uplifting |
| Technical | Precise and jargon-friendly |
| Minimalist | Simple and concise |
| Luxury | Elegant and premium wording |
| Youthful | Trendy and modern style |
| Quirky | Fun and creative language |
| Sales-Oriented | Persuasive and conversion-focused |
| Informative | Educational and factual |
| Formal | Structured and traditional |
| Authoritative | Expert 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)
Modern white ceramic wall tiles with glossy finish for bathroom and kitchen interiors
White glossy ceramic wall tiles
Premium glossy white ceramic wall tiles designed for elegant modern interiors
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:
Request parameters
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| apiKey | string | Ja | Dein 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
{
"is_verify": true
} {
"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.
{
"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
Besonders empfohlen für Mode, Möbel, Elektronik und Fliesen-Produkte.