Image Analysis API

KI Alt-Text & Bild-Metadaten API

Bilder rein. SEO-Metadaten raus.

Ein API-Endpoint. Du sendest ein Bild – LucidSEO analysiert es per KI und liefert sofort Alt-Text, Meta-Description, Caption und Keywords zurück. Fertig für CMS, Shop oder DAM.

POST /api/photos/analyze
202 Accepted
{
  "alt_text": "Gotisches Kirchenportal mit konzentrischen Bögen in Girona, Spanien",
  "description": "Frontale Aufnahme eines gotischen Kirchenportals mit charakteristischen konzentrischen Spitzbögen und ornamentalen Säulen in Girona",
  "caption": "Gotisches Kirchenportal in Girona, Barri Vell",
  "keywords": [
    "Girona", "gotische Architektur", "Kirchenportal",
    "Altstadt", "Spanien"
  ],
  "photo_id": 42
}
4 Felder
Pro Analyse-Response
<2s
Ø Antwortzeit
8
Sprachen unterstützt
REST API
JSON · Webhook · Async
So funktioniert es

Vier Schritte von Bild zu fertigen Metadaten.

01
Bild-URL senden

Du sendest die URL deines Bildes – LucidSEO lädt es herunter und analysiert es. Maximale Dateigröße: 5 MB.

02
KI analysiert

Bildinhalt, Kontext und Stimmung werden erkannt. Sprache frei wählbar.

03
SEO optimiert

Alle Felder sind auf Suchmaschinenrichtlinien und Zeichengrenzen abgestimmt.

04
Webhook Callback

Strukturierter JSON-Response via Webhook – direkt ins CMS, in den Shop oder die Datenbank.

Response Felder

Was du zurückbekommst.

Jede Analyse liefert vier SEO-relevante Felder – zeichengrenzen-konform und sofort verwendbar.

Alle Felder sind auf gängige CMS-Standards abgestimmt.
Zeichengrenzen: alt_text ≤ 120, description ≤ 155, caption ≤ 80, keywords max. 10 Begriffe.

alt_text
string · max 120 Zeichen
Beschreibt den Bildinhalt präzise für Screenreader und Suchmaschinen. Primäres Keyword natürlich eingebettet.
description
string · max 155 Zeichen
Click-optimierter Beschreibungstext für Suchergebnisse. Enthält Handlungsaufforderung und Kontext.
caption
string · max 80 Zeichen
Journalistisch formulierter Bildunterschrifts-Text. Geeignet für Blog, Galerie und Social Media.
keywords
array · max 10 Begriffe
Relevante Suchbegriffe, priorisiert nach Suchvolumen und Bildkontext.
Landschaft Sonnenuntergang Weinberge + weitere
Use Cases

Gemacht für Teams, die im großen Maßstab arbeiten.

E-Commerce & Online-Shops

Produktbilder ohne Alt-Text sind für Suchmaschinen unsichtbar – und Metadaten manuell für große Kataloge zu pflegen ist schlicht nicht skalierbar. LucidSEO generiert automatisch SEO-konformen Alt-Text, Meta-Descriptions, Captions und Keywords für jedes Produktbild. Ob 500 oder 500.000 Artikel: Jedes Bild erhält in unter zwei Sekunden individuell analysierte Metadaten. Binde die API direkt in deinen Produkt-Import-Prozess ein, verbinde sie per Webhook mit CMS, PIM oder Shop-System – und die fertigen Metadaten warten, bevor ein Produkt live geht. Zeichengrenzen, Keyword-Relevanz und Barrierefreiheitsstandards werden vollautomatisch eingehalten.

Fotografen & Stockagenturen

Jedes Foto auf einer Stockplattform braucht präzise Keywords, eine treffende Caption und eine auffindbare Beschreibung. Sie manuell für Hunderte von Aufnahmen nach einem Shooting zu schreiben ist mühsam – und meist inkonsistent. LucidSEO analysiert jedes Bild individuell und liefert nach Relevanz gerankte Keywords, eine journalistische Caption und eine auf Auffindbarkeit optimierte Description. Verbinde die API mit deinem Upload-Workflow oder DAM und erhalte strukturierte Metadaten, sobald eine Datei eingeht. Die API versteht Bildinhalt – Architektur, Menschen, Stimmung, Ort – und übersetzt ihn in Begriffe, nach denen Käufer und Suchmaschinen suchen.

DAM-Systeme & Agenturen

Für Agenturen und Teams mit großen Asset-Bibliotheken ist konsistente Metadatenpflege unverzichtbar. Fehlender oder inkonsistenter Alt-Text ist sowohl ein SEO-Problem als auch ein Barrierefreiheitsproblem. LucidSEO integriert sich per REST API und Webhook direkt in jedes DAM oder Content-Pipeline-System und stellt sicher, dass jedes Asset beim Eingang getaggt wird. Setze einen Kontext-Hinweis pro Kunde oder Projekt – „Luxus-Immobilienfotografie" oder „B2B-SaaS-Screenshots" – und die KI kalibriert Keywords und Descriptions entsprechend. Das Ergebnis: eine durchsuchbare, SEO-fertige Asset-Bibliothek ohne manuellen Tagging-Aufwand. Metadaten-reiche Assets als festen Bestandteil deines Produktions-Workflows an Kunden liefern.

API Dokumentation

Integration in wenigen Minuten.

POST https://lucidseo.net/api/photos/analyze Bildanalyse (async)
// cURL Beispiel
curl -X POST https://lucidseo.net/api/photos/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/image.jpg", "webhook_url": "https://deineshop.de/api/seo/webhook", "context": "Produktfotografie"}'
Parameter Typ Beschreibung
url required string URL des zu analysierenden Bildes. JPG, PNG, WebP. Max. 5 MB.
webhook_url string URL die nach der Analyse mit dem Ergebnis aufgerufen wird.
context string Optionaler Kontext-Hinweis für präzisere Keywords (z. B. "Produktfoto E-Commerce").
PHP / Laravel Beispiel Laravel
$response = Http::withToken(config('lucidseo.api_key'))
    ->post('https://lucidseo.net/api/photos/analyze', [
        'url' => $imageUrl,
        'webhook_url' => 'https://deineshop.de/api/seo/webhook',
        'context' => 'Produktfotografie',
    ]);
 
// Response: {"message": "Analyse started.", "photo_id": 42}
// Ergebnis kommt via Webhook mit X-LucidSeo-Signature Header
Preise

Einfache Preise. Keine Überraschungen.

Free
Gratis
  • 50 Analysen/Monat
  • 1 Domain
  • Kein Overage – bei Limit pausiert
Kostenlos starten
Starter
9
/Monat
  • 300 Analysen/Monat
  • 1 Domain
  • +15% Overage à 0,04 €/Analyse
Jetzt starten
Pro
29
/Monat
  • 1,500 Analysen/Monat
  • 3 Domains
  • +15% Overage à 0,04 €/Analyse
Jetzt starten
Agency
79
/Monat
  • 6,000 Analysen/Monat
  • 10 Domains
  • +15% Overage à 0,04 €/Analyse
Jetzt starten
FAQ

Alles, was du wissen musst.

Keine Antwort gefunden? Schreib uns über die Kontaktseite.

Wie generiere ich Alt-Text automatisch?

Sende eine POST-Anfrage an den /api/photos/analyze-Endpoint mit der URL deines Bildes und deinem API-Key. LucidSEO lädt das Bild herunter, analysiert es per KI und liefert Alt-Text, eine Meta-Description, eine Caption und Keywords – entweder direkt im Response oder per Webhook-Callback an eine URL, die du angibst.

Welche Sprachen werden unterstützt?

LucidSEO unterstützt derzeit 8 Sprachen: Englisch, Deutsch, Französisch, Spanisch, Italienisch, Niederländisch, Portugiesisch und Polnisch. Die Ausgabesprache lässt sich pro Anfrage festlegen, was die Lokalisierung von Metadaten für internationale Shops, Stockplattformen oder DAM-Systeme einfach macht.

Kann ich Bilder in großen Mengen verarbeiten?

Ja. Jede Anfrage analysiert ein Bild asynchron. Für die Massenverarbeitung werden Anfragen parallel gesendet und die Ergebnisse per Webhook gesammelt. Es gibt keinen dedizierten Batch-Endpoint, aber die asynchrone Architektur mit Webhook-Callbacks ist für hochvolumige Pipelines ausgelegt und blockiert deine Anwendung nicht.

Wie funktioniert der Webhook-Callback?

Übergib einen webhook_url-Parameter mit deiner Anfrage. Sobald die Analyse abgeschlossen ist, sendet LucidSEO eine POST-Anfrage an deine URL mit dem strukturierten JSON-Ergebnis. Der Callback enthält einen X-LucidSeo-Signature-Header zur Verifizierung, mit dem du bestätigen kannst, dass der Payload von LucidSEO stammt.

Welche Bildformate und Dateigrößen werden unterstützt?

LucidSEO akzeptiert JPG-, PNG- und WebP-Bilder, die über eine öffentliche URL erreichbar sind. Die maximale Dateigröße beträgt 5 MB. Das Bild muss öffentlich zugänglich sein – authentifizierte oder private URLs werden nicht unterstützt.

Wie genau sind die KI-generierten Metadaten?

Die Genauigkeit hängt von der Bildqualität und Motivklarheit ab. Für Standard-Produktfotos, Architekturaufnahmen und redaktionelle Bilder liefert die KI konsistent verwertbaren, SEO-konformen Output. Der optionale context-Parameter – etwa „Luxus-E-Commerce-Produktfotografie" – verbessert die Keyword-Präzision und den Beschreibungston für spezialisierte Anwendungsfälle deutlich.

Benötige ich eine Kreditkarte für den Start?

Nein. Jeder API-Key enthält ein kostenloses Test-Kontingent, damit du LucidSEO integrieren und evaluieren kannst, ohne Zahlungsdaten anzugeben. Sobald das Test-Kontingent aufgebraucht ist, kannst du auf einen bezahlten Plan upgraden, der zu deinem Volumen passt.

Wofür wird der context-Parameter verwendet?

Der context-Parameter ist ein optionaler Freitext-Hinweis, der der KI mehr über deinen Anwendungsfall mitteilt – zum Beispiel „Immobilienfotografie" oder „Kindermode E-Commerce". Er hilft dem Modell, relevantere Keywords und einen passenderen Ton zu generieren, sodass der Output besser zu deiner spezifischen Inhaltsdomain passt.