- 23 Apr 2025
- Drucken
Thumbnail hochladen
- Aktualisiert am 23 Apr 2025
- Drucken
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.
Rufen Sie die Upload-URL über den API-Endpunkt „Get Thumbnail Upload URL“ ab.
Die Upload-URL enthält ein Token, das 4 Stunden lang gültig ist.
Geben Sie in der curl-Anforderung die Upload-URL, das Token und den Mime-Typ des Bildes an.
Der Dateiparameter sollte auf den Dateinamen der lokalen Miniaturbilddatei gesetzt werden, mit einem führenden @/.
Wenn der Upload erfolgreich war, wird als Antwort ein 204-Code ausgegeben.
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.