ForHosting KIT · Bilder bearbeiten & analysieren

Bildwasserzeichen: Position, Skalierung und Rahmen

Dieser Rechner bestimmt genau, wo ein Wasserzeichen liegt, bevor Pixel verändert werden.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Geben Sie die Maße des Grundbildes und des Wasserzeichens, einen Skalierungsfaktor und eine von neun Ankerpositionen an. Das Ergebnis enthält die Koordinaten links, oben, rechts und unten sowie die endgültige Breite und Höhe. Eine optionale proportionale Verkleinerung passt ein zu großes Wasserzeichen ohne Verzerrung in das Grundbild ein.

Beschreiben Sie beide Bilder im selben Koordinatensystem

Tragen Sie zuerst Breite und Höhe des Grundbildes und danach die natürlichen Maße des Wasserzeichens ein. Pixel sind die übliche Einheit, doch jede einheitlich verwendete positive Einheit funktioniert. Der Skalierungsfaktor wird gleichmäßig auf beide Maße angewendet und bewahrt dadurch das Seitenverhältnis. Der Wert 0.5 halbiert jede Abmessung, während 2 beide verdoppelt. Der Rechner weist fehlende, nullwertige, negative, nicht numerische oder unendliche Angaben zurück, weil sie kein verwendbares Rechteck definieren. Er liest und verändert keine Bilddateien, ermittelt nicht das sichtbare Motiv innerhalb transparenter Ränder und berücksichtigt keine Drehung. Verwenden Sie die vollständigen Leinwandmaße beider Bilder. Die ausgegebene Breite und Höhe beschreiben die gesamte platzierte Leinwand des Wasserzeichens einschließlich transparenter Pixel, die zur Quelldatei gehören.

Wählen Sie einen Anker und lesen Sie den Begrenzungsrahmen

Die Position bestimmt einen von neun Ankern: vier Ecken, die Mitte jeder Kante oder den exakten Mittelpunkt. Der Ursprung liegt oben links, wie bei Rasterkoordinaten üblich: x wächst nach rechts und y nach unten. Ein oben links verankertes Wasserzeichen beginnt auf beiden Achsen bei null; unten rechts endet es an Breite und Höhe des Grundbildes. Zentrierte Varianten teilen den verbleibenden Raum gleichmäßig und können Dezimalwerte ergeben. Die Antwort liefert x und y für die obere linke Ecke, width und height für die platzierte Größe sowie right und bottom für die gegenüberliegenden Kanten. Gemeinsam bilden diese Werte den Rahmen, den viele Bildbibliotheken benötigen. Es wird kein Abstand hinzugefügt. Falls Ihre Gestaltung einen Randabstand vorsieht, ändern Sie anschließend die Koordinaten oder vergrößern Sie zuvor das gedachte Rechteck.

Behandeln Sie übergroße Wasserzeichen bewusst

Die Skalierung wird vor der Positionierung ausgewertet. Überschreitet das skalierte Wasserzeichen Breite oder Höhe des Grundbildes, meldet die Standardeinstellung einen Eingabefehler, statt unerwartet abzuschneiden. Aktivieren Sie scale_down, wenn eine automatische Anpassung gewünscht ist. Der Rechner wählt das kleinere verfügbare Verhältnis für Breite und Höhe, wendet diese zusätzliche Verringerung einheitlich an und stellt sicher, dass beide Maße passen. Die Option vergrößert ein Wasserzeichen niemals, sondern greift nur bei einer zu großen Zielgröße ein. Die Antwort enthält die endgültige Skalierung und das Kennzeichen scaled_down, damit Ihr Ablauf jede Änderung protokollieren kann. So funktioniert eine Regel unverzerrt für Querformat, Hochformat und Vorschaubilder. Die Berechnung ist deterministisch, lädt nichts hoch, nutzt kein Netzwerk und kostet bei automatisierter Nutzung $0.002 je API-Anfrage.

Anwendungsfälle

Überlagerungsbefehl vorbereiten

Berechnen Sie genaue Koordinaten und Maße, bevor Sie Logo und Grundbild an eine Bildbibliothek übergeben.

Responsive Regeln prüfen

Testen Sie dieselbe Skalierung und denselben Anker für Desktop-, Mobil-, Hochformat- und Vorschaubilder, ohne Dateien zu verändern.

Unbeabsichtigtes Abschneiden vermeiden

Weisen Sie ein übergroßes Wasserzeichen zurück oder passen Sie es vor der produktiven Überlagerung proportional an.

Häufige Fragen

Verändert diese Funktion ein Bild?

Nein. Sie berechnet nur die Geometrie und liefert einen Rahmen für einen anderen Renderer oder eine Bildbibliothek.

Wo liegt der Koordinatenursprung?

Oben links im Grundbild. x nimmt nach rechts und y nach unten zu.

Bleibt das Seitenverhältnis beim Skalieren erhalten?

Ja. Derselbe Faktor gilt für beide Maße, auch bei der optionalen proportionalen Anpassung.

Was geschieht mit einem zu großen Wasserzeichen?

Die Anfrage schlägt standardmäßig fehl. Aktivieren Sie scale_down, um es proportional einzupassen.

Enthält die Position einen Randabstand?

Nein. Anker berühren die jeweilige Kante oder zentrieren das Rechteck exakt. Fügen Sie den gewünschten Abstand danach hinzu.

Was kostet eine API-Anfrage?

Der Preis beträgt $0.002 je Anfrage. Dieselbe deterministische Berechnung ist im Browser kostenlos möglich.

Für Entwickler — API-Zugang

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.

Endpunkt

POSThttps://api.kit.forhosting.com/image/watermark-image

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

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/image/watermark-image \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"base_width":1200,"base_height":800,"watermark_width":300,"watermark_height":120}'

const res = await fetch("https://api.kit.forhosting.com/image/watermark-image", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "base_width": 1200,
    "base_height": 800,
    "watermark_width": 300,
    "watermark_height": 120
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/watermark-image",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "base_width": 1200,
    "base_height": 800,
    "watermark_width": 300,
    "watermark_height": 120
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/watermark-image", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"base_width":1200,"base_height":800,"watermark_width":300,"watermark_height":120}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"base_width":1200,"base_height":800,"watermark_width":300,"watermark_height":120}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/watermark-image", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "base_width": 1200,
  "base_height": 800,
  "watermark_width": 300,
  "watermark_height": 120
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.watermark_image",
  "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.

Preis

pro Anfrage$0.002

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

Limits

`max_mb`	15
`max_megapixels`	12

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →