Thumbnail-Bild erstellen

Thumbnail-Bild hochladen

Ein benutzerdefiniertes Thumbnail lädst du hoch, indem du eine PUT-Anfrage mit Formulardaten sendest, die eine JPEG- oder PNG-Datei (max. 8 MB) enthalten, an den Endpoint /videos/:videoId/thumbnail. PNG-Dateien werden automatisch nach JPEG konvertiert.

Der Content-Type muss multipart/form-data sein und nicht application/json.

CURL


curl -X PUT https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/thumbnail \
-H "Authorization: Bearer YOUR_TOKEN" \
-F "file=@[PATH_TO_THUMBNAIL_FILE]"

JavaScript / Node.js


const response = await fetch(`https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/thumbnail`, {
method: 'PUT',
body: [THUMBNAIL_FILE],
headers: {
  'Authorization': `Bearer YOUR_TOKEN`,
  'Content-Type': 'multipart/form-data'
}
});

PHP


  $client = new GuzzleHttp\Client();
  $response = $client->request('PUT', 'https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/thumbnail', [
    'body' => [THUMBNAIL_FILE],
    'headers' => [
      'Authorization' => 'Bearer YOUR_TOKEN',
      'Content-Type' => 'multipart/form-data'
    ]
  ]);

Antwort

Das hochgeladene Bild wird automatisch in mehrere Auflösungsvarianten skaliert. Es werden nur Größen erzeugt, die der Quelldatei entsprechen oder kleiner sind. Die Antwort ist das vollständige Video-Objekt.

src.thumbnails wird durch mehrere Auflösungsvarianten des hochgeladenen Bildes ersetzt.
src.thumbnailUrl zeigt auf die 1080p-Variante (oder die höchste verfügbare Variante) des neuen Thumbnails.


{
  "id": "[VIDEO_ID]",
  "title": "Your video title",
  "src": {
    "thumbnails": [
      // ... 2160p, 1440p if source image is large enough
      {
        "name": "1080p", "width": 1920, "height": 1080,
        "formats": {
          "jpeg": { "url": "https://cdn.example.com/thumbnails/.../custom/a1b2c3d4-1080p.jpg", "fileSize": 9180 },
          "webp": { "url": "https://cdn.example.com/thumbnails/.../custom/a1b2c3d4-1080p.webp", "fileSize": 4256 }
        }
      },
      {
        "name": "720p", "width": 1280, "height": 720,
        "formats": {
          "jpeg": { "url": "https://cdn.example.com/thumbnails/.../custom/a1b2c3d4-720p.jpg", "fileSize": 5180 },
          "webp": { "url": "https://cdn.example.com/thumbnails/.../custom/a1b2c3d4-720p.webp", "fileSize": 2106 }
        }
      },
      // ... 480p, 360p, 240p
    ],
    "thumbnailUrl": "https://cdn.example.com/thumbnails/.../custom/a1b2c3d4-1080p.jpg",
    ...
  },
  ...
}

src.thumbnailUrl ist veraltet und wird in einer zukünftigen Version entfernt. Verwende stattdessen src.thumbnails.