Analyse

AI Studio

Die AI Studio API ermöglicht den Zugriff auf KI-gestützte Funktionen für Analyse, Bild-, Code- und Design-Generierung.

Endpunkte

Methode	Endpunkt	Beschreibung
`POST`	`/api/v1/ai/analyze`	Inhaltsanalyse durchführen
`POST`	`/api/v1/ai/generate-image`	Bild generieren
`POST`	`/api/v1/ai/generate-code`	Code generieren
`POST`	`/api/v1/ai/generate-design`	Design generieren
`POST`	`/api/v1/ai/generate-svg`	SVG generieren
`POST`	`/api/v1/ai/save-generated-image`	Generiertes Bild speichern

Authentifizierung

AI-Endpunkte erfordern zusätzlich zur API-Key-Authentifizierung gültige AI-Provider-Credentials in Ihrer Organisation.

Rate Limits

AI-Endpunkte haben spezielle Rate Limits:

Plan	Anfragen/Minute	Anfragen/Tag
Free	5	50
Starter	10	200
Professional	30	1.000
Enterprise	100	Unbegrenzt

Analysiert Text oder Bilder und extrahiert relevante Informationen.

Endpunkt

POST /api/v1/ai/analyze

Request-Body

{
  "organizationId": "org_xyz789",
  "type": "text",
  "content": "Analysieren Sie diese Produktbeschreibung und extrahieren Sie die wichtigsten Verkaufsargumente...",
  "options": {
    "language": "de",
    "format": "structured"
  }
}

Analyse-Typen

Typ	Beschreibung
`text`	Textanalyse (Sentiment, Keywords, Zusammenfassung)
`image`	Bildanalyse (Objekte, Farben, Stimmung)
`seo`	SEO-Analyse (Keywords, Meta-Empfehlungen)
`accessibility`	Barrierefreiheits-Prüfung

Response

{
  "success": true,
  "data": {
    "type": "text",
    "results": {
      "sentiment": "positive",
      "keywords": ["Innovation", "Qualität", "Nachhaltigkeit"],
      "summary": "Die Produktbeschreibung hebt drei Hauptvorteile hervor...",
      "suggestions": [
        "Fügen Sie einen Call-to-Action hinzu",
        "Erwähnen Sie konkrete Zahlen/Fakten"
      ]
    },
    "usage": {
      "tokens": 450,
      "cost": 0.0045
    }
  }
}

Für detaillierte Dokumentation siehe Analyse.

Bildgenerierung

Generiert Bilder basierend auf Textbeschreibungen.

Endpunkt

POST /api/v1/ai/generate-image

Request-Body

{
  "organizationId": "org_xyz789",
  "prompt": "Modernes Bürogebäude mit Glasfassade bei Sonnenuntergang, professionelle Architektur-Fotografie",
  "options": {
    "size": "1024x1024",
    "style": "photorealistic",
    "quality": "hd"
  }
}

Response

{
  "success": true,
  "data": {
    "imageUrl": "https://cdn.codefluss.com/generated/img_abc123.png",
    "prompt": "...",
    "revisedPrompt": "A modern office building with glass facade during sunset...",
    "usage": {
      "credits": 1
    }
  }
}

Für detaillierte Dokumentation siehe Bildgenerierung.

Code-Generierung

Generiert Code basierend auf Beschreibungen.

Endpunkt

POST /api/v1/ai/generate-code

Request-Body

{
  "organizationId": "org_xyz789",
  "prompt": "Erstelle eine React-Komponente für ein responsives Kontaktformular mit Validierung",
  "options": {
    "language": "typescript",
    "framework": "react",
    "style": "functional"
  }
}

Für detaillierte Dokumentation siehe Code-Generierung.

Design-Generierung

Generiert Design-Vorschläge und Layouts.

Endpunkt

POST /api/v1/ai/generate-design

Request-Body

{
  "organizationId": "org_xyz789",
  "prompt": "Modernes Hero-Section Design für eine SaaS-Landing-Page",
  "options": {
    "type": "section",
    "style": "minimal",
    "colorScheme": "dark"
  }
}

Für detaillierte Dokumentation siehe Design-Generierung.

Generiertes Bild speichern

Speichert ein generiertes Bild in der Media-Library.

Endpunkt

POST /api/v1/ai/save-generated-image

Request-Body

{
  "organizationId": "org_xyz789",
  "imageUrl": "https://cdn.codefluss.com/generated/img_abc123.png",
  "filename": "hero-background",
  "folder": "generiert/hero",
  "alt": "Modernes Bürogebäude bei Sonnenuntergang"
}

Response

{
  "success": true,
  "data": {
    "mediaId": "med_xyz789",
    "url": "https://cdn.codefluss.com/media/org_xyz789/hero-background.png",
    "thumbnailUrl": "https://cdn.codefluss.com/media/org_xyz789/hero-background_thumb.png"
  }
}

Fehler

Code	Beschreibung
`400`	Ungültiger Prompt oder Optionen
`401`	Nicht authentifiziert
`402`	AI-Credits aufgebraucht
`403`	Keine AI-Berechtigung
`429`	AI Rate Limit überschritten
`500`	KI-Provider-Fehler

Nächste Schritte

Analyse – Detaillierte Analyse-Optionen
Bildgenerierung – Bildgenerierungs-Optionen