# 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.

<p class="callout info">Der ALT-Text wird automatisiert KI-gestützt erstellt. Die Ausgabe sollte bei sensiblen oder rechtlich relevanten Inhalten geprüft werden.</p>

#### Aufruf

<table border="1" id="bkmrk-api-name-alttext-api" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>**API Name**  
</td><td>alttext  
</td></tr><tr><td>**API Type** </td><td>image  
</td></tr><tr><td>**HTTP-Methode** </td><td>POST  
</td></tr></tbody></table>

#### Header-Parameter

<table border="1" id="bkmrk-parameter-format-pfl" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 26.4519%;"></col><col style="width: 16.0689%;"></col><col style="width: 8.043%;"></col><col style="width: 49.5578%;"></col></colgroup><tbody><tr><td>**Parameter**  
</td><td>**Format** </td><td>**Pflicht**  
</td><td>**Erläuterung**  
</td></tr><tr><td>makler  
</td><td>Integer  
</td><td>Ja  
</td><td>Ihre Makler-ID bei versicherungsmarkt.de  
</td></tr><tr><td>Apikey  
</td><td>String  
</td><td>Ja  
</td><td>Ihr API-Schlüssel für den Zugriff auf die Schnittstelle  
</td></tr><tr><td>Content-Type  
</td><td>String  
</td><td>Ja  
</td><td>Muss auf `application/json` gesetzt werden  
</td></tr></tbody></table>

#### Eingabeparameter im POST-Body

<table border="1" id="bkmrk-parameter-format-pfl-1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 26.4519%;"></col><col style="width: 16.0689%;"></col><col style="width: 8.043%;"></col><col style="width: 49.5578%;"></col></colgroup><tbody><tr><td>**Parameter**  
</td><td>**Format** </td><td>**Pflicht**  
</td><td>**Erläuterung**  
</td></tr><tr><td>image  
</td><td>String  
</td><td>Ja  
</td><td>Das Bild als Data-URL im Format `data:image/...;base64,...`  
</td></tr></tbody></table>

#### Ausgabeparameter

<table border="1" id="bkmrk-parameter-format-erl" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 32.3857%;"></col><col style="width: 19.9011%;"></col><col style="width: 47.7132%;"></col></colgroup><tbody><tr><td>**Parameter**  
</td><td>**Format** </td><td>**Erläuterung**  
</td></tr><tr><td>altText  
</td><td>Text  
</td><td>Der generierte deutsche ALT-Text für das übergebene Bild.  
</td></tr></tbody></table>

#### Beispiel-Aufruf

<p class="callout info">https://api.versicherungsmarkt.de/alttext/image</p>

#### Beispiel-Header

```plaintext
makler: 7661
Apikey: XXXXXXXXX
Content-Type: application/json
```

#### Beispiel-POST-Body

```json
{
  "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD..."
}
```

#### Beispiel-Antwort

```json
{
  "success": true,
  "data": {
    "altText": "Roter Kleinwagen vor Einfamilienhaus mit gepflegtem Vorgarten"
  }
}
```

#### Beispiel-Fehlerantwort

```json
{
  "success": false,
  "error": [
    "Kein Bild übergeben"
  ]
}
```