ForHosting KIT · Bilder bearbeiten & analysieren

Thumbnail erstellen

Ein Thumbnail ist eine kleine, stark verkleinerte Vorschauversion eines Bildes, wie sie Galerien, Onlineshops und Content-Systeme für Übersichten verwenden. Das Tool erzeugt aus einer Originaldatei eine passend kleine Version mit geringer Dateigröße, ohne den Bildinhalt selbst zu verändern oder Details zu beschneiden.

● Stabilpro Anfrage + pro Bild$0.002

Ausführen — $0.002 + $0.005/Bild API ansehen

Nutzen Sie es über WebAPIE-MailApp baldTelegram bald

Online ausführen

Führen Sie dies mit Ihrem Konto auf unseren Servern aus. Kostenlose Tools laufen in Ihrem Browser; dieses wird zum oben genannten Preis von Ihrem KIT-Guthaben abgebucht.

Übliche Thumbnail-Größen

Vorschaubilder liegen meist zwischen 100 und 400 Pixeln Kantenlänge, je nach Einsatzort – kleiner für eine Listenansicht, größer für eine Kachelgalerie. Sie geben die gewünschte Größe an, das Tool skaliert das Originalbild passend herunter und behält dabei das Seitenverhältnis bei, sofern nicht ausdrücklich ein festes Format verlangt wird. Für eine ganze Galerie lässt sich dieselbe Zielgröße auf beliebig viele Bilder anwenden, sodass am Ende ein einheitliches Rasterbild entsteht.

Kleine Datei, geringe Ladezeit

Ein Thumbnail soll vor allem schnell laden, nicht in hoher Detailschärfe überzeugen. Die Ausgabedatei wird entsprechend komprimiert, sodass sie deutlich weniger wiegt als das Original – wichtig für Seiten mit vielen kleinen Vorschaubildern, etwa eine Produktliste oder ein Blog-Archiv, bei denen jedes zusätzliche Kilobyte pro Bild die Ladezeit der gesamten Seite verlängert und sich über Dutzende Vorschaubilder hinweg deutlich summiert.

Unterschied zum einfachen Ändern der Größe

Anders als eine einfache Größenänderung ist ein Thumbnail bewusst auf eine kleine Zielgröße mit geringer Dateigröße ausgelegt und eignet sich nicht als Ersatz für ein mittelgroßes Anzeigebild. Für größere Zwischenformate, etwa eine Detailansicht oder eine Produktseite, ist die einfache Größenänderung die passendere Wahl, da sie mehr Bilddetail erhält und nicht auf minimale Dateigröße optimiert ist, sondern auf eine ausgewogene Bildqualität.

Für viele Bilder gleichzeitig

Wer Vorschaubilder für einen ganzen Katalog braucht, kann mehrere Dateien in einer Anfrage hochladen; jedes Bild wird einzeln in dieselbe Zielgröße gebracht. Das erspart, jedes Vorschaubild einzeln von Hand zu erzeugen, und liefert ein einheitliches Ergebnis über die gesamte Galerie hinweg, auch wenn die Ausgangsbilder unterschiedliche Auflösungen und Seitenverhältnisse hatten und aus verschiedenen Kameras oder Quellen stammten und entsprechend uneinheitlich waren.

Anwendungsfälle

Vorschaubilder für einen Blog

Katrin Baumann erstellt aus jedem Artikelbild ein kleines Thumbnail für die Übersichtsseite ihres Blogs, damit diese schnell lädt und nicht durch große Originaldateien ausgebremst wird.

Produktübersicht im Onlineshop

Weber Metallbau GmbH zeigt in der Kategorieansicht kleine Vorschaubilder statt der großformatigen Produktfotos, damit die Seite auch mit vielen Artikeln schnell aufgebaut ist.

Vorschaubilder für eine Dokumentenablage

Sabine Schneider legt gescannte Belege in einem internen System ab, das für jede Datei ein kleines Vorschaubild in der Liste anzeigt.

Häufige Fragen

Welche Größe hat ein Thumbnail?

Sie legen die Kantenlänge in Pixeln selbst fest; üblich sind Werte zwischen 100 und 400 Pixeln, je nach Einsatzort.

In welchem Format wird das Thumbnail ausgegeben?

Im ursprünglichen Format der Quelldatei, sofern Sie keine zusätzliche Umwandlung angeben. JPG, PNG und WebP werden unterstützt.

Kann ich Thumbnails für mehrere Bilder auf einmal erstellen?

Ja. Sie können mehrere Dateien in einer Anfrage hochladen; jedes Bild wird einzeln auf die angegebene Zielgröße gebracht.

Was kostet ein Thumbnail?

$0.002 pro Anfrage und $0.005 pro Bild.

Wird die Originaldatei nach der Verarbeitung gespeichert?

Nein. Sie wird ausschließlich für die Dauer der Erstellung des Thumbnails übertragen und danach nicht aufbewahrt.

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/thumbnail

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/thumbnail \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"image":"https://ejemplo.com/imagen.jpg"}'

const res = await fetch("https://api.kit.forhosting.com/image/thumbnail", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "image": "https://ejemplo.com/imagen.jpg"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/thumbnail",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "image": "https://ejemplo.com/imagen.jpg"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/thumbnail", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"image":"https://ejemplo.com/imagen.jpg"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/thumbnail", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "image": "https://ejemplo.com/imagen.jpg"
}

Beispiel-Antwort

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

pro Bild$0.005

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 →