ForHosting KIT · Bilder bearbeiten & analysieren

Bestimmte Farbe im Bild ersetzen

Machen Sie in einer Pixelliste aus Rot Grün: Mit einer Toleranz von 32 ändern sich das reine Rot und die zwei fast roten Töne, also werden 3 von 5 Pixeln ersetzt. Jeder Kanal wird einzeln verglichen, so werden auch Kantenschatten erfasst. Kostenlos in Ihrem Browser.

  • Kostenlos
  • Läuft in Ihrem Browser
  • Ohne Anmeldung
  • Ihre Daten bleiben auf Ihrem Gerät
Nutzen Sie es über WebAPIE-MailTelegramApp bald
Wenn Sie eingeben
Pixel
#FF0000, #FF2020, #00FF00, #0000FF, #FE0101
Ziel
#FF0000
Toleranz
32
Ersetzung
#00FF00
Erhalten Sie
Pixel
#00FF00, #00FF00, #00FF00, #0000FF, #00FF00
Anzahl ersetzt
3
Gesamtanzahl
5

Ein Pixel gilt als Treffer, wenn seine Rot-, Grün- und Blau-Kanäle um höchstens die eingestellte Toleranz vom Ziel abweichen: Bei null werden nur exakte Treffer ersetzt, während ein größerer Wert auch Schattierungen und die Kantenglättung an den Rändern erfasst. Es ist die deterministische, offline-fähige Version eines Umfärbens per Zauberstab – ohne Bilddekodierung, ohne KI, nur eine klare Kanal-Distanzregel, die Sie überall nachvollziehen können.

Was es bedeutet, eine Farbe mit Toleranz zu ersetzen

Echte Bilder enthalten fast nie eine einzige flache Farbe. Ein rotes Logo ist von einem Hof rosafarbener Kantenglättungspixel umgeben, und das Foto eines roten Autos hält je nach Licht Dutzende Rottöne bereit. Würden Sie nur den exakten Hexadezimalwert austauschen, sähe das Ergebnis fleckig und amateurhaft aus.

Die Toleranz löst das, indem sie eine Umgebung um das Ziel definiert: Dieses Werkzeug misst für jedes Pixel die größte absolute Differenz zwischen den Rot-, Grün- und Blau-Kanälen und ersetzt das Pixel, wenn diese Distanz kleiner oder gleich Ihrer Toleranz ist. Eine Toleranz von 0 bedeutet strikte Gleichheit – nützlich für Symbole, Sprites und flache Oberflächengrafiken. Werte zwischen 16 und 48 sind der übliche Arbeitsbereich für Verläufe und Fotos.

Ziel, Toleranz und Ersatz richtig wählen

Beginnen Sie damit, die Farbe abzutasten, die verschwinden soll. Das Ziel akzeptiert einen üblichen Hexadezimalwert #RRGGBB; falls Sie den genauen Wert nicht kennen, verrät Ihnen ein Werkzeug für dominante Farben oder Paletten, woraus das Bild wirklich besteht. Stellen Sie dann die Toleranz von null aufwärts ein: Führen Sie mit 0 aus, prüfen Sie, wie viele Pixel ersetzt wurden, und erhöhen Sie den Wert, bis der Hof um Ihr Motiv abgedeckt ist, ohne in benachbarte Elemente überzulaufen.

Der Ersatz ist ebenfalls eine Hexadezimalfarbe, die wörtlich in jedes passende Pixel geschrieben wird – es wird nicht gemischt, der Austausch bleibt also scharf. Eine Schutzregel, die Sie kennen sollten: Die Toleranz muss null oder eine positive ganze Zahl bis 255 sein.

Wo sie in einem echten Arbeitsablauf passt

Ein- und Ausgabe sind Listen von Pixelfarben, keine kodierten Bilddateien – diese Fähigkeit ist damit ein Baustein und kein vollwertiger Fotoeditor. Wer sie nutzt, extrahiert typischerweise die Pixel einer kleinen Ressource – ein Favicon, eine Diagrammserie, ein Spiel-Sprite, eine QR-artige Markierung –, färbt sie hier um und setzt das Bild auf seiner Seite wieder zusammen. Marketing-Teams nutzen sie, um Farbvarianten eines einzigen Master-Renderings zu erzeugen.

Diagramm-Pipelines nutzen sie, um die Farbe einer Serie ohne erneutes Rendering zu ändern. Barrierefreiheits-Werkzeuge nutzen sie, um problematische Farben auf konforme abzubilden.

Produktvarianten umfärben

Tauschen Sie die Hauptfarbe eines Produkt-Renderings aus, um alle Farbvarianten aus einer einzigen Master-Datei zu erzeugen – die Toleranz deckt die Schattierung an den Rändern ab.

Diagramm oder Sprite neu einfärben

Überführen Sie eine Farbe der alten Palette in die neue Markenfarbe, Pixel für Pixel in einer kleinen Grafik, ohne einen Editor zu öffnen.

Eine Farbe für Barrierefreiheit korrigieren

Ersetzen Sie eine nicht konforme Markenfarbe durch ihr zugängliches Äquivalent in Symbolen und Oberflächengrafiken, bevor Sie veröffentlichen.

Was kostet das?

Außerdem ist die Ausführung in Ihrem Browser auf dieser Seite kostenlos.

Wie wird ein Treffer entschieden?

Ein Pixel passt, wenn die größte Differenz pro Kanal (Rot, Grün oder Blau) zur Zielfarbe kleiner oder gleich der Toleranz ist. Bei Toleranz 0 werden nur exakte Treffer ersetzt.

Was passiert bei negativer Toleranz?

Eine negative Toleranz ist sinnlos und deutet meist auf einen Fehler im aufrufenden Code hin.

Nimmt sie eine Bilddatei entgegen?

Nein. Sie arbeitet auf den Pixelfarben des Bildes, übergeben als Liste von Hexadezimalfarben #RRGGBB, und gibt die umgefärbte Liste zurück. Das Dekodieren und erneute Zusammensetzen des Bildes liegt bei Ihnen.

Welche Toleranz sollte ich wählen?

Nehmen Sie 0 für Symbole, Sprites und flächige Grafiken und etwa 16 bis 48 für Verläufe und Fotos. Beginnen Sie bei null, prüfen Sie, wie viele Pixel sich geändert haben, und erhöhen Sie, bis der Saum erfasst ist.

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

POSThttps://api.kit.forhosting.com/image/color-replace

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

curl -X POST https://api.kit.forhosting.com/image/color-replace \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pixels":["#FF0000","#FF2020","#00FF00","#0000FF"],"target":"#FF0000","replacement":"#00FF00"}'
{
  "pixels": [
    "#FF0000",
    "#FF2020",
    "#00FF00",
    "#0000FF"
  ],
  "target": "#FF0000",
  "replacement": "#00FF00"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.color_replace",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

max_pixels262144
HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Die API zum Ersetzen von Farben nimmt die Pixelfarben eines Bildes, eine Zielfarbe, eine Toleranz und eine Ersatzfarbe entgegen und gibt die Pixelliste zurück, in der jedes passende Pixel bereits ausgetauscht ist.

Was es bedeutet, eine Farbe mit Toleranz zu ersetzen

Da die Regel ein einfacher numerischer Vergleich ist, erzeugt dieselbe Eingabe stets dieselbe Ausgabe: Sie testen im Browser und automatisieren danach exakt denselben Aufruf über die API mit identischen Ergebnissen – genau das, was Sie brauchen, wenn das Umfärben eine Build-Pipeline oder einen Variantengenerator speist.

Ziel, Toleranz und Ersatz richtig wählen

Eine negative Toleranz wird mit einem invalid_input-Fehler abgelehnt statt still begrenzt, denn ein negativer Radius ist sinnlos und deutet meist auf einen Fehler im aufrufenden Code hin, den Sie lieber sofort sehen, als später ein subtil falsches Bild zu debuggen.

Wo sie in einem echten Arbeitsablauf passt

Der ganze Vorgang ist günstig genug, um kostenlos in Ihrem Browser auf dieser Seite zu laufen, und kostet $0.002 pro Anfrage über die API, wenn Sie ihn automatisieren. Es wird keine Datei hochgeladen oder gespeichert, die Berechnung ist vollständig deterministisch, und das Limit von 262144 Pixeln pro Aufruf deckt Sprites und Symbole mit Reserve ab.

Ist das Ergebnis deterministisch?

Ja. Die Regel ist ein einfacher Kanal-Distanzvergleich ohne Zufall; dieselbe Eingabe erzeugt daher im Browser und über die API stets dieselbe Ausgabe.

Gibt es ein Größenlimit?

Bis zu 262144 Pixel pro Aufruf – das deckt Symbole, Sprites und kleine Ressourcen mit Reserve ab.

Vollständige KIT-Dokumentation lesen →