Analyse
Die Analyse-API ermöglicht KI-gestützte Inhaltsanalysen für verschiedene Anwendungsfälle.
Endpunkt
POST /api/v1/ai/analyzeRequest-Body
{
"organizationId": "org_xyz789",
"type": "text",
"content": "Ihr zu analysierender Inhalt...",
"options": {
"language": "de",
"format": "structured",
"depth": "detailed"
}
}Pflichtfelder
| Feld | Typ | Beschreibung |
|---|---|---|
organizationId | string | Organisations-ID |
type | string | Analyse-Typ |
content | string | Zu analysierender Inhalt |
Optionale Felder
| Feld | Typ | Default | Beschreibung |
|---|---|---|---|
options.language | string | de | Ausgabesprache |
options.format | string | structured | structured, prose, json |
options.depth | string | standard | quick, standard, detailed |
Analyse-Typen
Text-Analyse (text)
Analysiert Texte auf Sentiment, Keywords und Struktur.
{
"type": "text",
"content": "Unser neues Produkt revolutioniert die Art und Weise...",
"options": {
"aspects": ["sentiment", "keywords", "readability", "summary"]
}
}Response
{
"success": true,
"data": {
"results": {
"sentiment": {
"score": 0.85,
"label": "positive",
"confidence": 0.92
},
"keywords": [
{ "word": "Revolution", "relevance": 0.95 },
{ "word": "Produkt", "relevance": 0.88 },
{ "word": "Innovation", "relevance": 0.82 }
],
"readability": {
"fleschScore": 65,
"level": "Mittelstufe",
"averageSentenceLength": 15
},
"summary": "Der Text beschreibt ein innovatives Produkt..."
}
}
}SEO-Analyse (seo)
Analysiert Inhalte für Suchmaschinenoptimierung.
{
"type": "seo",
"content": "<html>...</html>",
"options": {
"targetKeywords": ["webdesign", "agentur"],
"url": "https://example.com/webdesign"
}
}Response
{
"success": true,
"data": {
"results": {
"score": 72,
"issues": [
{
"severity": "warning",
"type": "meta_description",
"message": "Meta-Beschreibung ist zu kurz (45 Zeichen)",
"recommendation": "Erweitern Sie auf 150-160 Zeichen"
},
{
"severity": "error",
"type": "h1",
"message": "Mehrere H1-Tags gefunden",
"recommendation": "Verwenden Sie nur ein H1-Tag pro Seite"
}
],
"keywordDensity": {
"webdesign": 2.3,
"agentur": 1.1
},
"suggestions": [
"Fügen Sie das Keyword 'agentur' in den Titel ein",
"Ergänzen Sie Alt-Texte für 3 Bilder"
]
}
}
}Bild-Analyse (image)
Analysiert Bilder und extrahiert Informationen.
{
"type": "image",
"content": "https://example.com/image.jpg",
"options": {
"aspects": ["objects", "colors", "text", "mood"]
}
}Response
{
"success": true,
"data": {
"results": {
"objects": [
{ "label": "Person", "confidence": 0.98 },
{ "label": "Laptop", "confidence": 0.95 },
{ "label": "Schreibtisch", "confidence": 0.91 }
],
"colors": {
"dominant": ["#1a1a2e", "#4a90a4", "#ffffff"],
"palette": "professional-cool"
},
"text": {
"detected": true,
"content": "Company Logo"
},
"mood": {
"label": "professionell",
"attributes": ["modern", "fokussiert", "geschäftlich"]
},
"suggestedAlt": "Person arbeitet an einem Laptop in einem modernen Büro"
}
}
}Barrierefreiheits-Analyse (accessibility)
Prüft Inhalte auf Barrierefreiheit (WCAG).
{
"type": "accessibility",
"content": "<html>...</html>",
"options": {
"standard": "WCAG21",
"level": "AA"
}
}Response
{
"success": true,
"data": {
"results": {
"score": 85,
"level": "AA",
"violations": [
{
"wcag": "1.1.1",
"severity": "error",
"element": "img.hero-image",
"issue": "Fehlendes alt-Attribut",
"fix": "Fügen Sie einen beschreibenden Alt-Text hinzu"
}
],
"warnings": [
{
"wcag": "1.4.3",
"element": ".small-text",
"issue": "Kontrastverhältnis 3.8:1 (Minimum: 4.5:1)"
}
],
"passed": 42
}
}
}Kosten und Credits
| Analyse-Typ | Credits pro Anfrage |
|---|---|
text (quick) | 0.5 |
text (detailed) | 1 |
seo | 2 |
image | 1.5 |
accessibility | 2 |
Fehler
| Code | Beschreibung |
|---|---|
400 | Ungültiger Inhalt oder Optionen |
402 | Credits aufgebraucht |
413 | Inhalt zu groß (max 100KB Text, 10MB Bild) |
Nächste Schritte
- Bildgenerierung – Bilder generieren
- AI Studio – Übersicht