Thumbnail hochladen
  • 23 Apr 2025

Thumbnail hochladen


Artikel-Zusammenfassung

Hochladen eines Thumbnails mit einer vorhandenen Video-URL

Wenn bereits eine Upload-URL für Ihr Thumbnail generiert wurde, können Sie diese stattdessen zum Hochladen des Thumbnails verwenden.

  1. Rufen Sie die Upload-URL über den API-Endpunkt „Get Thumbnail Upload URL“ ab.

  2. Die Upload-URL enthält ein Token, das 4 Stunden lang gültig ist.

  3. Geben Sie in der curl-Anforderung die Upload-URL, das Token und den Mime-Typ des Bildes an.

  4. Der Dateiparameter sollte auf den Dateinamen der lokalen Miniaturbilddatei gesetzt werden, mit einem führenden @/.

  5. Wenn der Upload erfolgreich war, wird als Antwort ein 204-Code ausgegeben.

  6. Schlägt der Upload fehl, lautet die Antwort 1101 - Upload verweigert, da die gebuchte Speicherkapazität erreicht ist.

Hier ein Beispiel für eine curl-Anfrage:

curl -X POST -F "file=@/thumbnail.jpg" "https://file-1-b.video-cdn.net/FQMx5EcAGqS-789vU7s6QY/78463.UPLOAD_Bzg_-8GaCUeRDYhaLd3eCf.jpeg/still?mime-type=image%2Fjpeg&token=abc123"

URL

UPLOAD_URL

Ein Beispiel für eine Upload-URL ist oben abgebildet. Diese wird vom API-Endpunkt „Get Thumbnail URL“ zurückgegeben.

Parameter

token

Das Token wird zusammen mit der Upload-URL zurückgegeben und ist für 4 Stunden gültig (siehe Warnung oben)

mime-type

Die Upload-URL enthält auch den Mime-Typ des Bildes.

Form Daten

file=@/<FILENAME>

Geben Sie den Dateinamen (und ggf. den Pfad) der hochzuladenden lokalen Miniaturbilddatei an.

Stellen Sie sicher, dass Sie dem Dateinamen ein „@/“ voranstellen.

Hier sind einige zusätzliche Tipps zur Optimierung des Uploads:

  • Verwenden Sie ein verlustfreies Komprimierungstool, um die Größe des Thumbnails ohne Qualitätseinbußen zu verringern.

  • Ändern Sie die Größe des Thumbnails auf die gewünschten Abmessungen.

  • Vermeiden Sie die Verwendung von transparenten Hintergründen, da dies die Dateigröße erhöhen kann.


War dieser Artikel hilfreich?