Generierung Bildbeschreibungen (ALT-Texte)
Beschreibung
Diese Schnittstelle erstellt automatisiert einen deutschen, SEO-konformen ALT-Text für ein übergebenes Bild.
Der ALT-Text beschreibt konkret, was auf dem Bild sichtbar ist, und wird auf maximal 125 Zeichen begrenzt.
Einsatzzweck
Diese API kann Sie dabei unterstützen, Bilder automatisiert mit passenden ALT-Texten zu versehen. Dies verbessert die Barrierefreiheit und kann die Suchmaschinenoptimierung von Webseiten unterstützen.
Voraussetzungen/Einschränkungen
Diese API kann nur von unseren Kunden mit einem gültigen Content- und Wartungsvertrag verwendet werden.
Der Zugriff ist nur von authorisierten Domains zugelassen.
Der ALT-Text wird automatisiert KI-gestützt erstellt. Die Ausgabe sollte bei sensiblen oder rechtlich relevanten Inhalten geprüft werden.
Aufruf
| API Name |
alttext |
| API Type |
image |
| HTTP-Methode |
POST |
Header-Parameter
| Parameter |
Format |
Pflicht |
Erläuterung |
| makler |
Integer |
Ja |
Ihre Makler-ID bei versicherungsmarkt.de |
| Apikey |
String |
Ja |
Ihr API-Schlüssel für den Zugriff auf die Schnittstelle |
| Content-Type |
String |
Ja |
Muss auf application/json gesetzt werden |
Eingabeparameter im POST-Body
| Parameter |
Format |
Pflicht |
Erläuterung |
| image |
String |
Ja |
Das Bild als Data-URL im Format data:image/...;base64,... |
Ausgabeparameter
| Parameter |
Format |
Erläuterung |
| altText |
Text |
Der generierte deutsche ALT-Text für das übergebene Bild. |
Beispiel-Aufruf
https://api.versicherungsmarkt.de/alttext/image
Beispiel-Header
makler: 7661
Apikey: XXXXXXXXX
Content-Type: application/jsonBeispiel-POST-Body
{
"image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD..."
}Beispiel-Antwort
{
"success": true,
"data": {
"altText": "Roter Kleinwagen vor Einfamilienhaus mit gepflegtem Vorgarten"
}
}Beispiel-Fehlerantwort
{
"success": false,
"error": [
"Kein Bild übergeben"
]
}
No Comments