Video-Seitenverhältnis für eine Plattform prüfen
Ein Video kann technisch gültig sein und trotzdem schlecht zu seinem Ziel passen.
Im Browser ausführen – kostenlos
Dieses Werkzeug vergleicht das angegebene Verhältnis von Breite zu Höhe mit dem festen Rahmen einer bestimmten Platzierung auf einer Social-Media-Plattform. Es zeigt Ihnen, ob die Geometrie übereinstimmt, ob eine schmalere Quelle seitliche Balken benötigt oder ob bei einer breiteren Quelle die Seiten beschnitten werden. Das Video wird weder hochgeladen noch dekodiert: Geben Sie Verhältnis, Plattform und Platzierung ein, um eine deterministische Antwort für Planung, Prüfung oder einen automatisierten Veröffentlichungsablauf zu erhalten.
Wählen Sie zuerst das genaue Veröffentlichungsziel
Die Eignung eines Seitenverhältnisses richtet sich nach der Platzierung und nicht nur nach dem Namen der Plattform. Ein normales YouTube-Video verwendet einen horizontalen Rahmen, YouTube Shorts dagegen einen vertikalen. Instagram unterscheidet ebenfalls zwischen Hochformat-Feed, quadratischem Feed, Reels und Stories. Wählen Sie genau das Paar, das den späteren Einsatz beschreibt, und geben Sie das sichtbare Seitenverhältnis als Breite:Höhe ein, etwa 16:9, 9:16, 4:5 oder 1:1. Dezimalwerte sind für seltenere Formate zulässig. Das Werkzeug vereinheitlicht Plattform und Platzierung in Kleinbuchstaben, schlägt den festgelegten Zielrahmen nach und vergleicht beide Zahlenverhältnisse. Dateiname, Auflösung, Rotationsmarkierung und kodierter Medienstrom werden nicht untersucht. Enthält eine Handyaufnahme Orientierungsmetadaten, ermitteln Sie die Abmessungen nach der Drehung und übermitteln Sie das tatsächlich sichtbare Verhältnis. Nicht unterstützte Kombinationen werden ausdrücklich abgelehnt. Dadurch kann ein automatischer Prozess nicht versehentlich eine Feed-Regel auf eine Story anwenden oder die Vorgabe einer anderen Plattform übernehmen.
Deuten Sie Übereinstimmung, Balken und Beschnitt
Eine Übereinstimmung bedeutet, dass Quelle und Ziel innerhalb einer sehr kleinen Gleitkommatoleranz dieselbe mathematische Form besitzen. Eine geometrische Anpassung ist nicht erforderlich. Das Ergebnis mit Balken bedeutet, dass die Quelle schmaler als der Zielrahmen ist. Wird das gesamte Bild erhalten, bleibt an den Seiten ungenutzter Raum; dies wird oft Pillarboxing genannt, obwohl die API dafür die allgemeine Kategorie letterboxed verwendet. Ein Beschnitt bedeutet, dass die Quelle breiter als das Ziel ist. Um den Rahmen in voller Höhe zu füllen, müsste Inhalt am linken und rechten Rand entfernt werden. Diese Bezeichnungen beschreiben eine zentrierte geometrische Anpassung und garantieren nicht das Verhalten jeder Upload-Oberfläche. Eine Plattform kann manuelles Neurahmen, einen unscharfen Hintergrund oder mehrere Verhältnisse anbieten und ihr Produkt ändern. Nutzen Sie das Ergebnis, um redaktionellen Prüfbedarf zu erkennen. Kontrollieren Sie bei Beschnitt Personen, Untertitel und Logos nahe den Rändern. Entscheiden Sie bei Balken, ob ein gestalteter Hintergrund besser geeignet ist.
Prüfen Sie vor Veröffentlichung und Transkodierung
Führen Sie die Prüfung aus, sobald ein Ziel feststeht und bevor Zeit in endgültiges Rendering, Hochladen oder Medienkontrolle fließt. Ein Redaktionssystem kann die vorgesehene Plattform und Platzierung beim Inhalt speichern, das sichtbare Verhältnis aus zuverlässigen Metadaten berechnen und diese Fähigkeit als Validierungsschritt aufrufen. Exakte Treffer dürfen automatisch fortfahren. Andere Ergebnisse können eine Prüfaufgabe anlegen, eine vorbereitete Alternativfassung auswählen oder das Material an eine getrennte Beschnittberechnung weiterreichen. Speichern Sie required_ratio im Prüfprotokoll, damit die Redaktion nachvollziehen kann, welches Ziel die Entscheidung bestimmt hat. Die Antwort wiederholt außerdem normalisierte Plattform, Platzierung und Eingabe, was Protokolle bei der Verteilung einer Quelle auf mehrere Kanäle verständlicher macht. Diese Fähigkeit skaliert keine Pixel, berechnet keine Sicherheitsbereiche, prognostiziert keine Kompression und behauptet nicht, dass eine Plattform den Upload ablehnt. Über die API kostet jede deterministische Prüfung $0.002; eine Übertragung der Videodatei findet nicht statt.
Anwendungsfälle
Prüfen Sie Inhalte vor der Planung
Markieren Sie ein unpassendes Format, bevor die Warteschlange das Video an die gewählte Platzierung sendet.
Wählen Sie die passende Masterfassung
Vergleichen Sie Quelle und Ziel und leiten Sie den Auftrag an eine horizontale, quadratische oder vertikale Fassung weiter.
Erstellen Sie eine redaktionelle Prüfregel
Lassen Sie bei Beschnitt die Ränder und bei Balken die geplante Hintergrundgestaltung prüfen.
Häufige Fragen
Was bedeutet eine Übereinstimmung?
Das angegebene Verhältnis hat dieselbe Zahlenform wie die hinterlegte Vorgabe für diese Plattform und Platzierung.
Warum meldet das Werkzeug seitliche Balken?
Die Quelle ist schmaler als der Rahmen; vollständig erhalten blieben daher seitlich Balken oder ein anderer Hintergrund.
Was bedeutet Beschnitt in diesem Ergebnis?
Die Quelle ist breiter als das Ziel, sodass eine zentrierte Füllung Teile der linken und rechten Seite entfernen würde.
Wird das Video hochgeladen oder bearbeitet?
Nein. Das Werkzeug vergleicht nur Verhältnisse und empfängt, dekodiert, speichert, skaliert oder transkodiert keine Medien.
Was kostet eine Prüfung über die API?
Jede API-Anfrage kostet $0.002. Da kein Video übertragen wird, fällt keine variable Medienverarbeitungsgebühr an.
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
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/video-aspect-platform-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"ratio":"16:9","platform":"youtube","placement":"video"}'const res = await fetch("https://api.kit.forhosting.com/video/video-aspect-platform-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/video/video-aspect-platform-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/video-aspect-platform-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"ratio":"16:9","platform":"youtube","placement":"video"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"ratio":"16:9","platform":"youtube","placement":"video"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/video-aspect-platform-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "video.video_aspect_platform_check",
"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
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. |