Bildgenerierung

Die Image Generation API ermöglicht die KI-gestützte Erstellung von Bildern basierend auf Textbeschreibungen.

Endpunkt

POST /api/v1/ai/generate-image

Request-Body

{
  "organizationId": "org_xyz789",
  "prompt": "Ihre Bildbeschreibung...",
  "options": {
    "size": "1024x1024",
    "style": "photorealistic",
    "quality": "hd",
    "n": 1
  }
}

Pflichtfelder

Feld	Typ	Beschreibung
`organizationId`	string	Organisations-ID
`prompt`	string	Bildbeschreibung (max 4000 Zeichen)

Optionale Felder

Feld	Typ	Default	Beschreibung
`options.size`	string	`1024x1024`	Bildgröße
`options.style`	string	`natural`	Stil-Präferenz
`options.quality`	string	`standard`	Qualitätsstufe
`options.n`	integer	`1`	Anzahl zu generierender Bilder (1-4)

Bildgrößen

Größe	Seitenverhältnis	Verwendung
`256x256`	1:1	Thumbnails, Icons
`512x512`	1:1	Avatare, kleine Bilder
`1024x1024`	1:1	Standard, Hero-Bilder
`1792x1024`	16:9	Banner, Header
`1024x1792`	9:16	Stories, vertikale Banner

Stile

Stil	Beschreibung
`natural`	Natürlich aussehende Bilder
`photorealistic`	Fotorealistische Darstellung
`artistic`	Künstlerischer Stil
`illustration`	Illustrationsartig
`3d-render`	3D-Rendering-Stil
`minimalist`	Minimalistisch, clean

Qualitätsstufen

Qualität	Beschreibung	Credits
`standard`	Schnelle Generierung, gute Qualität	1
`hd`	Höhere Auflösung, mehr Details	2

Beispiel-Request

curl -X POST "https://api.codefluss.com/v1/ai/generate-image" \
  -H "Authorization: Bearer cf_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "organizationId": "org_xyz789",
    "prompt": "Modernes minimalistisches Büro mit großen Fenstern, Pflanzen und natürlichem Licht, professionelle Innenarchitektur-Fotografie",
    "options": {
      "size": "1792x1024",
      "style": "photorealistic",
      "quality": "hd"
    }
  }'

Response

{
  "success": true,
  "data": {
    "id": "gen_abc123",
    "images": [
      {
        "url": "https://cdn.codefluss.com/generated/img_xyz789.png",
        "expiresAt": "2026-01-24T12:00:00Z"
      }
    ],
    "prompt": "Modernes minimalistisches Büro...",
    "revisedPrompt": "A modern minimalist office space with large floor-to-ceiling windows...",
    "metadata": {
      "size": "1792x1024",
      "style": "photorealistic",
      "quality": "hd"
    },
    "usage": {
      "credits": 2
    }
  }
}

Mehrere Bilder generieren

{
  "prompt": "Abstrakte geometrische Muster in Blautönen",
  "options": {
    "n": 4,
    "size": "1024x1024"
  }
}

Response

{
  "success": true,
  "data": {
    "images": [
      { "url": "https://cdn.codefluss.com/generated/img_001.png" },
      { "url": "https://cdn.codefluss.com/generated/img_002.png" },
      { "url": "https://cdn.codefluss.com/generated/img_003.png" },
      { "url": "https://cdn.codefluss.com/generated/img_004.png" }
    ],
    "usage": {
      "credits": 4
    }
  }
}

Bild in Media-Library speichern

Generierte Bilder werden temporär gespeichert und nach 24h gelöscht. Um ein Bild dauerhaft zu speichern:

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

{
  "organizationId": "org_xyz789",
  "imageUrl": "https://cdn.codefluss.com/generated/img_xyz789.png",
  "filename": "buero-hero",
  "folder": "hero-bilder",
  "alt": "Modernes Büro mit viel Tageslicht"
}

Prompt-Tipps

Gute Prompts

✅ "Professionelles Teamfoto in einem modernen Büro, natürliches 
    Licht, Business-Casual-Kleidung, freundliche Atmosphäre, 
    hochwertige Unternehmensfotografie"

✅ "Minimalistisches Logo-Design für eine Tech-Startup, 
    geometrische Formen, blau und weiß, sauber und modern"

✅ "Abstrakte Hintergrundgrafik mit fließenden Wellenformen, 
    Farbverlauf von dunkelblau zu türkis, geeignet für Website-Header"

Vermeiden

❌ "Ein schönes Bild" (zu vage)
❌ "Logo von Apple" (Markenrechtsverletzung)
❌ "Foto von Elon Musk" (echte Personen)

Inhaltsrichtlinien

Folgende Inhalte werden blockiert:

Gewalt oder Hassdarstellungen
Explizit sexuelle Inhalte
Bekannte Persönlichkeiten
Urheberrechtlich geschützte Charaktere
Täuschendes oder irreführendes Material

Fehler

Code	Beschreibung
`400`	Ungültiger Prompt oder Optionen
`402`	Credits aufgebraucht
`403`	Prompt verstößt gegen Richtlinien
`429`	Rate Limit überschritten

Nächste Schritte

Code-Generierung – Code generieren
AI Studio – Übersicht aller AI-Funktionen