Transparenter

Bild per Drag & Drop einfügen, Farben anklicken die transparent werden sollen, als PNG mit Alpha speichern. Gleiche Funktion auch via API.

Bild hier ablegen

oder klicken zum Hochladen (PNG, JPG, WebP, GIF)

Transparenzfarben

Noch keine Farben ausgewählt.

API-Dokumentation

Dieselbe Funktion programmatisch: POST ein Bild + eine Liste von Farben, erhalte ein PNG mit Alpha-Kanal zurück.

Endpoint

POST https://transparenter.minicon.eu/api/transparent

Authentifizierung

API-Key per Header. Keys werden serverseitig in der Env-Var API_KEYS (kommasepariert) verwaltet. Ist API_KEYS leer, ist die API offen.

Authorization: Bearer <your-api-key>
# oder
X-Api-Key: <your-api-key>

Request — multipart/form-data

curl -X POST https://transparenter.minicon.eu/api/transparent \
  -H "Authorization: Bearer YOUR_KEY" \
  -F "image=@/path/to/input.png" \
  -F 'colors=["#ffffff","#00ff00"]' \
  -F "tolerance=20" \
  -F "softness=24" \
  -F "despill=true" \
  --output output.png

Request — application/json

curl -X POST https://transparenter.minicon.eu/api/transparent \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "data:image/png;base64,iVBORw0KGgo...",
    "colors": ["#ffffff", {"r":0,"g":255,"b":0}],
    "tolerance": 20,
    "softness": 24,
    "despill": true
  }' \
  --output output.png

Parameter

image — Datei (multipart) oder base64 bzw. data-URL (JSON). Pflicht.
colors — Array aus Hex-Strings (#rrggbb) und/oder {r,g,b}-Objekten. Pflicht.
tolerance — Euklidischer RGB-Abstand (0–441). Default 16. Pixel innerhalb davon werden voll transparent.
softness — Breite der weichen Übergangszone ab Toleranz. Default 16. Ergibt weiche Kanten statt harter Schnitte.
despill — Boolean. Entfernt bei teil-transparenten Pixeln die Farbkomponente der Zielfarbe (gegen Farbsäume). Default true.

Response

200 — image/png mit Alpha.
400 — ungültige Eingabe.
401 — API-Key fehlt oder ungültig.
415 — falscher Content-Type.
500 — Bildverarbeitung fehlgeschlagen.

CORS

Erlaubter Origin wird über die Env-Var CORS_ALLOW_ORIGIN gesetzt (Default *). Preflight (OPTIONS) wird beantwortet.

JavaScript-Beispiel (fetch)

const fd = new FormData();
fd.append('image', file);
fd.append('colors', JSON.stringify(['#ffffff']));
fd.append('tolerance', '20');

const res = await fetch('https://transparenter.minicon.eu/api/transparent', {
  method: 'POST',
  headers: { Authorization: 'Bearer YOUR_KEY' },
  body: fd,
});
const blob = await res.blob();