ForHosting KIT · Video

Video-Wasserzeichen positionieren

Setzen Sie ein Logo von 240 mal 120 mit 32 Pixeln Rand in die rechte untere Ecke eines Bildes von 1920 mal 1080 und erhalten Sie seinen oberen linken Punkt, x 1648 und y 928, geprüft auf vollständige Passung. Kostenlos in Ihrem Browser.

Kostenlos
Läuft in Ihrem Browser
Ohne Anmeldung
Ihre Daten bleiben auf Ihrem Gerät

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Der Rechner liefert die Koordinaten des linken oberen Pixels, mit denen Sie ein Logo, Signet oder Markenbild in einer Ecke des Videos platzieren. Geben Sie Video- und Wasserzeichengröße, Ecke und einen einheitlichen Rand ein. Sie erhalten deterministische x- und y-Werte für Rendering oder Kodierung. Zugleich wird geprüft, ob das Bild vollständig in den Frame passt und weder beschnitten noch verdeckt wird.

Das Koordinatenergebnis verstehen

Compositing-Systeme positionieren Overlays meist anhand ihres linken oberen Pixels. Dieser Rechner verwendet dieselbe Konvention: x ist der horizontale Abstand von der linken Frame-Kante, y der vertikale Abstand von der oberen Kante. Oben links entsprechen beide Werte dem gewünschten Rand.

Oben rechts bleibt y der Rand; x ergibt sich aus Videobreite minus Wasserzeichenbreite minus Rand. Für untere Positionen gilt dasselbe vertikal. Das Ergebnis lässt sich direkt in Videofilter, Canvas-Renderer, Grafikvorlagen oder Kodierpipelines übernehmen.

Alle Angaben sind ganzzahlige Pixel, sodass keine Bruchteile oder stillen Rundungen entstehen. Die Antwort nennt Position und wirksamen Rand erneut und bleibt dadurch in Protokollen verständlich. Das Werkzeug berechnet ausschließlich Geometrie: Es untersucht keine Bildpunkte, berücksichtigt keine transparenten Innenränder und verändert keine Quelldatei.

Abmessungen und sicheren Rand wählen

Verwenden Sie die tatsächliche Größe des kodierten Frames, nicht die Anzeigegröße eines Players. Eine Quelle mit 1920 mal 1080 behält dieses Koordinatensystem auch in einer kleineren Anzeige, sofern sie vorher nicht ausdrücklich skaliert wird. Die Wasserzeichengröße muss der Größe beim Überlagern entsprechen.

Wird das Logo vorher skaliert, tragen Sie die resultierende Breite und Höhe ein. Der Rand ist ein einheitlicher Einzug von beiden Kanten der gewählten Ecke. Null richtet das Rechteck direkt an den Kanten aus; ein positiver Wert verschiebt es nach innen.

Die Anfrage wird abgelehnt, wenn eine Wasserzeichendimension den Frame übersteigt oder der Rand keinen vollständigen Platz lässt. Das schützt besonders schmale Hochformatvideos und gemischte Stapel. Transparente Pixel gehören zum Rechteck; entfernen Sie unnötige transparente Ränder, wenn das sichtbare Logo zu weit entfernt wirkt.

Koordinaten in der Produktion einsetzen

Setzen Sie x und y erst nach Größen- und Ausrichtungsänderungen in der Overlay-Stufe ein. Die Reihenfolge ist wichtig: Drehen oder beschneiden Sie das Video nach der Berechnung, kann sich die sichtbare Ecke ändern oder das Wasserzeichen aus dem Bild geraten. Rechnen Sie mit der endgültigen Geometrie oder erneut nach jeder Änderung von Breite oder Höhe.

Für Stapel können Ecke und Rand als Richtlinie feststehen, während jede Datei ihre echten Abmessungen liefert. So bleibt der Abstand in Querformat, Quadrat, Hochformat und Sonderformat einheitlich. Sichere Titelbereiche, Geräteaussparungen, Untertitel, Bauchbinden und wichtige Motive werden nicht bewertet; wählen Sie bei redaktionellem Bedarf eine andere Ecke oder mehr Abstand.

Eine encoderspezifische Formel wird nicht erzeugt, daher bleiben die Werte portabel.

Anwendungsfälle

Kodierbefehl vorbereiten

Berechnen Sie übertragbare x- und y-Werte, bevor Sie ein Logo in einen Transkodier- oder Renderingauftrag einfügen.

Markenexporte vereinheitlichen

Nutzen Sie dieselbe Ecke und denselben Abstand für Querformat-, Quadrat- und Hochformatversionen.

Automatische Layouts prüfen

Lehnen Sie zu große Bilder oder unmögliche Ränder vor einer aufwendigen Medienverarbeitung ab.

Häufige Fragen

Wofür stehen x und y?

Sie bezeichnen die Koordinaten der linken oberen Ecke des Wasserzeichenrechtecks, gemessen von der linken oberen Videoecke.

Wie wird der Rand angewendet?

Derselbe nicht negative Pixelabstand wird von der horizontalen und vertikalen Kante der gewählten Ecke nach innen gemessen.

Was geschieht bei einem zu großen Wasserzeichen?

Die Anfrage liefert einen Eingabefehler, weil das Bild nicht vollständig in den Frame passt.

Darf das Wasserzeichen die Kante berühren?

Ja. Mit einem Rand von null liegt seine Rechteckgrenze an beiden Kanten der gewählten Ecke.

Skaliert oder platziert das Werkzeug das Wasserzeichen im Video?

Nein. Es berechnet nur die Position und lädt, dekodiert, skaliert, rendert oder verändert keine Medien.

Darf das Wasserzeichen den Bildrand berühren?

Ja. Mit einem Rand von null liegt das Rechteck des Wasserzeichens direkt an beiden Bildkanten der gewählten Ecke; ein positiver Rand rückt es nach innen. Beachten Sie, dass transparente Ränder in Ihrer Logodatei mitzählen.

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/video/watermark-position

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/video/watermark-position \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"video_width":1920,"video_height":1080,"watermark_width":240,"watermark_height":120,"position":"bottom_right"}'

const res = await fetch("https://api.kit.forhosting.com/video/watermark-position", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "video_width": 1920,
    "video_height": 1080,
    "watermark_width": 240,
    "watermark_height": 120,
    "position": "bottom_right"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/video/watermark-position",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "video_width": 1920,
    "video_height": 1080,
    "watermark_width": 240,
    "watermark_height": 120,
    "position": "bottom_right"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/watermark-position", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"video_width":1920,"video_height":1080,"watermark_width":240,"watermark_height":120,"position":"bottom_right"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"video_width":1920,"video_height":1080,"watermark_width":240,"watermark_height":120,"position":"bottom_right"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/watermark-position", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "video_width": 1920,
  "video_height": 1080,
  "watermark_width": 240,
  "watermark_height": 120,
  "position": "bottom_right"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "video.watermark_position",
  "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`	500
`max_minutes`	60
`max_megapixels`	3.9

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.

Technische Hinweise

Koordinaten in der Produktion einsetzen

Jede API-Berechnung kostet $0.002; im Browser läuft dieselbe Arithmetik lokal.

Technische Fragen

Was kostet eine API-Anfrage?

Jede API-Anfrage kostet $0.002. Dieselbe deterministische Berechnung ist auch im Browser möglich.

Vollständige KIT-Dokumentation lesen →

Video-Wasserzeichen positionieren

Im Browser ausführen – kostenlos

Das Koordinatenergebnis verstehen

Abmessungen und sicheren Rand wählen

Koordinaten in der Produktion einsetzen

Anwendungsfälle

Kodierbefehl vorbereiten

Markenexporte vereinheitlichen

Automatische Layouts prüfen

Häufige Fragen

Verwandte Tools

Für Entwickler — API-Zugang

Endpunkt

Aufruf aus Ihrem Stack

Beispiel-Anfrage

Beispiel-Antwort

Preis

Limits

Fehler

Technische Hinweise

Koordinaten in der Produktion einsetzen

Technische Fragen

danke