ForHosting KIT · Bilder bearbeiten & analysieren

Gesichtsausschnitt zentriert berechnen – exakte Koordinaten

Ein Gesicht von 200 × 240 an Position 400, 250 in einem Foto mit 1200 × 900 ergibt ein Quadrat mit 360 Pixeln ab x 320, y 190, das Gesicht mittig und ein Viertel Rand auf jeder Seite. 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

Rechenbeispiel

Wenn Sie eingeben

Breite: 1.200
Höhe: 900
Gesicht X: 400
Gesicht Y: 250
Gesichtsbreite: 200
Gesichtshöhe: 240

Erhalten Sie

X: 320
Y: 190
Seite: 360
Rechts: 680

Der Schätzer für zentrierte Gesichtsausschnitte verwandelt das Ergebnis einer Gesichtserkennung in einen sofort nutzbaren quadratischen Bildausschnitt. Sie senden die Bildabmessungen und den erkannten Gesichtsrahmen — links, oben, Breite und Höhe — sowie einen optionalen Randabstand und erhalten die exakten Werte x, y und Seitenlänge eines Quadrats, das das Gesicht zentriert und vollständig im Bild hält. Es werden keine Pixel hochgeladen, dekodiert oder verändert: Dies ist reine, deterministische Geometrie, der Planungsschritt vor dem eigentlichen Zuschnitt.

Warum Sie den Ausschnitt vor dem Zuschneiden berechnen sollten

Gesichtsbezogene Zuschnitte begegnen Ihnen überall: Profilbilder, Avatar-Generatoren, Vorschaubilder für ein Personenverzeichnis, intelligente Vorschauen in einer Fotobibliothek. Überall ist das Dekodieren und Neukodieren des Bildes der teure Teil, und der ärgerliche Teil ist, hinterher festzustellen, dass der Bildausschnitt falsch sitzt — das Gesicht am Rand abgeschnitten, das Quadrat nicht zentriert, der Randabstand zu knapp für eine runde Maske. Diese Fähigkeit trennt die günstige Entscheidung von der teuren Ausführung.

Sie haben bereits einen Gesichtsdetektor laufen lassen und besitzen einen Begrenzungsrahmen; statt das Bild direkt in eine Bildverarbeitungspipeline zu geben und auf das Beste zu hoffen, fragen Sie zuerst die exakte Ausschnittsregion ab.

Wie die Region berechnet wird

Der Algorithmus ist bewusst einfach und vollständig deterministisch. Zuerst ermittelt er den Mittelpunkt des Gesichtsrahmens. Die Seitenlänge des Quadrats beginnt als der größere Wert aus Gesichtsbreite und -höhe, skaliert mit eins plus dem doppelten Randabstand — der Standardabstand von 0.25 fügt also auf jeder Seite ein Viertel der Gesichtsgröße hinzu und ergibt ein Quadrat mit dem Anderthalbfachen der größten Gesichtsseite, eine angenehme Rahmung für Porträts.

Ist dieses Quadrat größer als das Bild selbst, wird es auf die kleinste Bilddimension verkleinert. Anschließend wird das Quadrat auf den Gesichtsmittelpunkt zentriert und, wenn es über einen Rand hinausragen würde, wieder in das Bild zurückgeschoben — begrenzt, niemals verformt —, sodass die zurückgegebene Region stets ein gültiger Ausschnitt innerhalb der Bildgrenzen ist.

Wo er in eine Pipeline passt

Der typische Ablauf ist: Führen Sie Ihren bevorzugten Gesichtsdetektor aus, nehmen Sie den besten Begrenzungsrahmen, rufen Sie diesen Schätzer auf und übergeben Sie die zurückgegebene Region an ein echtes Zuschneidewerkzeug, etwa die Fähigkeit image.crop oder Ihren eigenen Thumbnail-Worker. Da der Schätzer niemals Bilddaten anfasst, können Sie ihn auch nur mit Metadaten nutzen — zum Beispiel, um vor dem Download zu entscheiden, ob ein erkanntes Gesicht nahe am Bildrand ein brauchbares Quadrat ergibt oder ob Sie auf ein anderes Layout ausweichen sollten.

Der Randabstand-Parameter ist Ihr einziger Regler: 0 ergibt ein enges Quadrat genau um die größte Gesichtsseite, 0.25 ist die Standard-Porträtrahmung, und 0.5 oder mehr lässt Raum für Haare und Schultern.

Anwendungsfälle

Quadratische Avatare aus Uploads erzeugen

Nehmen Sie den Gesichtsrahmen aus Ihrem Detektor und erhalten Sie das exakte Quadrat für Ihren Zuschneide-Worker, mit einem Randabstand, der eine runde Maske übersteht.

Eine Thumbnail-Pipeline vorab prüfen

Validieren Sie Gesichtsrahmen und berechnen Sie Ausschnittsregionen allein aus Metadaten, bevor Sie ein einziges Bild dekodieren und neu kodieren müssen.

Automatisierte Zuschnitte nachprüfen

Speichern Sie die geschätzte Region neben jedem Asset, damit sich ein schlecht gerahmter Avatar auf die exakten Koordinaten zurückführen lässt, die ihn erzeugt haben.

Häufige Fragen

Was kostet das?

Zudem ist die Nutzung im Browser auf dieser Seite kostenlos — mit exakt demselben Ergebnis.

Muss ich das Bild hochladen?

Nein. Es werden nur die Bildabmessungen und der Gesichtsrahmen gesendet — sechs Zahlen. Keine Pixeldaten werden übertragen, verarbeitet oder gespeichert.

Was passiert, wenn der Gesichtsrahmen aus dem Bild herausragt?

Ein Gesichtsrahmen außerhalb des Bildes ist fast immer ein Erkennungs- oder Koordinatenfehler, und er wird gemeldet, statt still zugeschnitten zu werden.

Was geschieht, wenn das Quadrat über einen Rand hinausragen würde?

Das Quadrat wird bei gleichbleibender Größe wieder in das Bild zurückgeschoben; ist es größer als das Bild selbst, wird es auf die kleinste Bilddimension verkleinert. Die zurückgegebene Region liegt stets vollständig innerhalb der Bildgrenzen.

Was bewirkt der Randabstand?

Er schafft Freiraum um das Gesicht, als Bruchteil der größten Gesichtsseite. Der Standardwert 0.25 ergibt ein Quadrat mit der 1.5-fachen größten Gesichtsseite; 0 ergibt einen engen Zuschnitt und 0.5 lässt großzügig Platz.

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/crop-face-center-estimate

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/crop-face-center-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1200,"height":900,"face_x":400,"face_y":250,"face_width":200,"face_height":240}'

const res = await fetch("https://api.kit.forhosting.com/image/crop-face-center-estimate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "width": 1200,
    "height": 900,
    "face_x": 400,
    "face_y": 250,
    "face_width": 200,
    "face_height": 240
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/crop-face-center-estimate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "width": 1200,
    "height": 900,
    "face_x": 400,
    "face_y": 250,
    "face_width": 200,
    "face_height": 240
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/crop-face-center-estimate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"width":1200,"height":900,"face_x":400,"face_y":250,"face_width":200,"face_height":240}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"width":1200,"height":900,"face_x":400,"face_y":250,"face_width":200,"face_height":240}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/crop-face-center-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "width": 1200,
  "height": 900,
  "face_x": 400,
  "face_y": 250,
  "face_width": 200,
  "face_height": 240
}

Beispiel-Antwort

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

Technische Hinweise

Kostenlos im Browser auf dieser Seite und per API für $0.002 pro Aufruf.

Warum Sie den Ausschnitt vor dem Zuschneiden berechnen sollten

Die Antwort ist ein schlichtes JSON-Objekt mit x, y und Seitenlänge, das Sie jedem Zuschneidewerkzeug übergeben können, von ImageMagick bis zu einem Canvas-Element, oder das Sie neben dem Asset speichern, damit die Entscheidung nachvollziehbar bleibt. Da die Berechnung reine Arithmetik auf sechs Zahlen ist, kostet sie fast nichts, antwortet in Mikrosekunden und verhält sich im Browser wie auf der API identisch — Sie können also interaktiv prototypen und später automatisieren, ohne ein einziges Ergebnis erneut prüfen zu müssen.

Wie die Region berechnet wird

Der Gesichtsrahmen selbst wird streng validiert: Negative Ursprünge, nicht positive Größen und Rahmen, die über die Bildränder hinausreichen, lösen einen invalid_input-Fehler aus, statt stillschweigend einen fehlerhaften Ausschnitt zu erzeugen, denn ein Gesichtsrahmen außerhalb des Bildes ist ein Detektorfehler, von dem Sie erfahren möchten.

Wo er in eine Pipeline passt

Alles läuft auf unserem globalen Edge-Netz, ohne dass etwas gespeichert wird, und dasselbe Modul steuert den kostenlosen Rechner auf dieser Seite — die Zahl, die Sie im Browser sehen, ist Byte für Byte die Zahl, die die API bei Ihrem automatisierten Aufruf zurückgibt.

Technische Fragen

Ist das Ergebnis deterministisch?

Ja. Es ist reine Arithmetik: gleiche Eingabe, gleiche Koordinaten, im Browser wie auf der API — ohne Zufall, Uhren oder Netzwerkzugriffe.

Vollständige KIT-Dokumentation lesen →

Gesichtsausschnitt zentriert berechnen – exakte Koordinaten

Im Browser ausführen – kostenlos

Rechenbeispiel

Warum Sie den Ausschnitt vor dem Zuschneiden berechnen sollten

Wie die Region berechnet wird

Wo er in eine Pipeline passt

Anwendungsfälle

Quadratische Avatare aus Uploads erzeugen

Eine Thumbnail-Pipeline vorab prüfen

Automatisierte Zuschnitte nachprü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

Warum Sie den Ausschnitt vor dem Zuschneiden berechnen sollten

Wie die Region berechnet wird

Wo er in eine Pipeline passt

Technische Fragen

danke