🖼️ Placeholder Image Service

Generiere schnell und einfach Platzhalterbilder für deine Projekte

Wie funktioniert es?

Füge einfach die gewünschten Dimensionen an die URL an:

/200x300 → 200px breit × 300px hoch
/600x400/jpg → JPG Format
/400x400?text=Hallo+Welt&bg=ff6b6b&fg=ffffff → Mit eigenem Text und Farben

Beispiele

Platzhalter 150x150 Pixel Platzhalter 200x100 Pixel mit Cyan Hintergrund Platzhalter 180x120 Pixel mit rotem Hintergrund Platzhalter 150x150 Pixel mit Mint Hintergrund Platzhalter 400x600 Pixel lila

Parameter

text
Eigener Text auf dem Bild (Standard: Dimensionen)
bg
Hintergrundfarbe als Hex (z.B. 333333 oder ff6b6b)
fg
Textfarbe als Hex (Standard: FFFFFF)
fontSize
Schriftgröße in Punkten (Standard: 36)
bold
Fett gedruckter Text (true oder false)
quality
JPEG-Qualität 0-100 (Standard: 85)

Formate

Unterstützte Bildformate: png (Standard), jpg, jpeg

API Spezifikation (für Tools & KI)

📋 Maschinenlesbare API-Dokumentation 
{
  "openapi": "3.0.0",
  "info": {
    "title": "Placeholder Image API",
    "version": "1.0.0",
    "description": "REST API zur Generierung von Platzhalterbildern"
  },
  "servers": [
    {
      "url": "https://placeholder.wittenwiler.org"
    }
  ],
  "paths": {
    "/{width}x{height}": {
      "get": {
        "summary": "Generiere Platzhalter",
        "parameters": [
          {
            "name": "width",
            "in": "path",
            "required": true,
            "schema": { "type": "integer", "minimum": 1 },
            "description": "Bildbreite in Pixel"
          },
          {
            "name": "height",
            "in": "path",
            "required": true,
            "schema": { "type": "integer", "minimum": 1 },
            "description": "Bildhöhe in Pixel"
          },
          {
            "name": "text",
            "in": "query",
            "schema": { "type": "string" },
            "description": "Anzuzeigender Text"
          },
          {
            "name": "bg",
            "in": "query",
            "schema": { "type": "string", "pattern": "^[0-9a-fA-F]{6}$" },
            "description": "Hintergrundfarbe (Hex ohne #)"
          },
          {
            "name": "fg",
            "in": "query",
            "schema": { "type": "string", "pattern": "^[0-9a-fA-F]{6}$" },
            "description": "Textfarbe (Hex ohne #)"
          },
          {
            "name": "fontSize",
            "in": "query",
            "schema": { "type": "integer", "minimum": 8 },
            "description": "Schriftgröße in Punkten"
          },
          {
            "name": "bold",
            "in": "query",
            "schema": { "type": "boolean" },
            "description": "Fettschrift aktivieren"
          },
          {
            "name": "quality",
            "in": "query",
            "schema": { "type": "integer", "minimum": 0, "maximum": 100 },
            "description": "JPEG Qualität"
          }
        ],
        "responses": {
          "200": {
            "description": "Erfolgreich generiertes Bild",
            "content": {
              "image/png": {},
              "image/jpeg": {}
            }
          },
          "400": {
            "description": "Ungültige Parameter"
          }
        }
      }
    },
    "/{width}x{height}/{format}": {
      "get": {
        "summary": "Generiere Platzhalter mit Format",
        "parameters": [
          {
            "name": "format",
            "in": "path",
            "required": true,
            "schema": { "type": "string", "enum": ["png", "jpg", "jpeg"] },
            "description": "Bildformat"
          }
        ]
      }
    }
  }
}

🤖 Anweisungen für KI & Automatisierung

Für KI-Assistenten und automatisierte Tools:

  • Basis-URL-Format: /{breite}x{höhe} oder /{breite}x{höhe}/{format}
  • Alle Parameter sind optional und können als Query-Parameter übergeben werden
  • Farbcodes ohne # Zeichen (z.B. ff0000 statt #ff0000)
  • Text sollte URL-encoded sein (z.B. Leerzeichen als + oder %20)
  • Standard-Werte: Format=png, bg=666666, fg=FFFFFF, fontSize=36, quality=85
  • HTTP-Methode: GET (keine Authentifizierung erforderlich)
  • Response: Binary Image Data (image/png oder image/jpeg)
  • Fehler-Codes: 400 bei ungültigen Parametern (mit JSON Error Response)