ForHosting KIT · Bilder bearbeiten & analysieren

Bild auf Seitenverhältnis zuschneiden

Ein Bild exakt auf ein Seitenverhältnis zuzuschneiden klingt einfach, wird jedoch leicht falsch berechnet.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Dieses Werkzeug übernimmt Breite und Höhe des Ausgangsbildes sowie ein Zielverhältnis wie 16:9 und liefert das größte passende Rechteck innerhalb des Bildes. Der Ausschnitt liegt mittig, sodass an gegenüberliegenden Seiten gleich viel entfernt wird. Es wird keine Bilddatei hochgeladen oder verändert. Sie erhalten wiederverwendbare Koordinaten für Editoren, Skripte, Bildverarbeitungsketten oder responsive Layouts.

Aus Abmessungen und Verhältnis wird ein Zuschneiderechteck

Geben Sie Breite und Höhe des Bildes in Pixeln ein und schreiben Sie das Zielverhältnis als Breite zu Höhe mit einem Doppelpunkt dazwischen. Übliche Werte sind 1:1 für quadratische Vorschaubilder, 4:3 für klassische Fotografie, 16:9 für Breitbildmedien und 9:16 für vertikale Storys. Der Rechner vergleicht das Ausgangsverhältnis mit dem gewünschten Verhältnis und erkennt dadurch, welche Abmessung bereits passt. Ist die Quelle zu breit, bleibt die volle Höhe erhalten und die Breite wird verringert. Ist sie zu hoch, bleibt die volle Breite erhalten und die Höhe wird verringert. x und y bezeichnen die linke obere Ecke, width und height die Größe. Zusammen bilden diese vier Werte den vollständigen Ausschnitt. Weil stets das größte passende Rechteck gesucht wird, geht keine nutzbare Fläche durch eine unnötige Verringerung beider Abmessungen verloren. Das Bild wird weder skaliert noch gestreckt oder aufgefüllt; beschrieben wird nur der mittlere Bereich, der erhalten bleiben soll.

Zentrierung und gebrochene Koordinaten verstehen

Bei einem zentrierten Ausschnitt wird an beiden gegenüberliegenden Rändern gleich viel entfernt. Muss ein Querformat schmaler werden, entspricht x der Hälfte der verworfenen Breite und y ist null. Muss ein Hochformat oder Quadrat niedriger werden, entspricht y der Hälfte der verworfenen Höhe und x ist null. Manche Kombinationen ergeben Dezimalwerte für Koordinaten oder Abmessungen. Das ist mathematisch richtig, denn der exakte Mittelpunkt oder das genaue Verhältnis kann zwischen physischen Pixeln liegen. Viele Bildbibliotheken akzeptieren Fließkommageometrie oder führen beim Rendern eine eigene Abtastung durch. Falls Ihre Bibliothek ganze Zahlen verlangt, wenden Sie deren dokumentierte Rundungsregel erst bei der endgültigen Integration an. Durch Rundung kann das Pixelrechteck geringfügig vom exakten Verhältnis abweichen. Präzise Ausgangswerte vermeiden eine versteckte Vorgabe und sorgen für deterministische Ergebnisse im Browser, über die API und in automatisierten Abläufen.

Das Ergebnis sicher in der Bildverarbeitung einsetzen

Behandeln Sie die Antwort als Geometrie und nicht als verändertes Bild. Übergeben Sie x, y, width und height an die Zuschneidefunktion Ihrer Grafikbibliothek, Ihres Kommandozeilenwerkzeugs, Ihrer Canvas-Routine oder Ihres Mediendienstes. Prüfen Sie, ob das Ziel den Ursprung links oben erwartet. Dieser Rechner verwendet die verbreitete Konvention, bei der x nach rechts und y nach unten zunimmt. Ermitteln Sie die Abmessungen aus der tatsächlich dekodierten Datei, statt einem Dateinamen oder den Metadaten einer anderen Version zu vertrauen. Das Verhältnis muss genau zwei positive Zahlen enthalten, die durch einen Doppelpunkt getrennt sind. Fehlerhafter Text, Nullen, negative Werte und andere Trennzeichen werden abgewiesen. Diese Strenge schützt Stapelverarbeitungen vor zahlreichen fehlerhaften Varianten. Die Berechnung nutzt weder Netzwerk noch Zufall, Zeitstempel oder verborgene Bildanalyse. Gleiche Eingaben liefern daher immer dieselbe Geometrie, die zwischengespeichert oder in einem Build-Manifest dokumentiert werden kann.

Anwendungsfälle

Einheitliche Inhalte für soziale Medien vorbereiten

Berechnen Sie mittige Bereiche in 1:1, 4:5 oder 9:16, bevor Sie kanalspezifische Varianten erzeugen.

Vorschaubild-Pipelines aufbauen

Übergeben Sie deterministische Geometrie an den Bildprozessor, damit jeder Rahmen ohne Verzerrung oder Rand gefüllt wird.

Redaktionelle Ausschnitte vorab ansehen

Zeigen Sie den größten mittigen Bereich, bevor die Redaktion eine motivbezogene Verschiebung auswählt.

Häufige Fragen

Schneidet dieses Werkzeug mein Bild zu oder lädt es hoch?

Nein. Es berechnet Koordinaten aus Abmessungen und Verhältnis, ohne Bilddaten zu empfangen, zu speichern, zu dekodieren oder zu ändern.

Was kostet die Berechnung?

Die API kostet $0.002 pro Anfrage. Die Browserversion führt dieselbe deterministische Berechnung lokal aus.

Warum kann das Ergebnis Dezimalpixel enthalten?

Der exakte Mittelpunkt oder das genaue Verhältnis kann zwischen Pixeln liegen. Dezimalwerte bewahren den mathematisch größten Ausschnitt.

Welche Schreibweise wird für das Verhältnis akzeptiert?

Verwenden Sie zwei positive Zahlen mit Doppelpunkt, etwa 16:9, 4:3, 1:1 oder 1.85:1. Andere Trennzeichen und Zusatztext werden abgewiesen.

Kann der Ausschnitt über das Ausgangsbild hinausragen?

Nein. Eine Abmessung entspricht immer der Quelle, während die andere passend zum Verhältnis verringert wird.

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-to-aspect

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-to-aspect \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1920,"height":1080,"ratio":"4:3"}'

const res = await fetch("https://api.kit.forhosting.com/image/crop-to-aspect", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "width": 1920,
    "height": 1080,
    "ratio": "4:3"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/crop-to-aspect",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "width": 1920,
    "height": 1080,
    "ratio": "4:3"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/crop-to-aspect", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"width":1920,"height":1080,"ratio":"4:3"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"width":1920,"height":1080,"ratio":"4:3"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/crop-to-aspect", 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": 1920,
  "height": 1080,
  "ratio": "4:3"
}

Beispiel-Antwort

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