Creare miniatura

Caricare l’immagine della miniatura

Per caricare una miniatura personalizzata invii una richiesta PUT con il campo multipart file, che contiene un JPEG o un PNG, all’endpoint /videos/:videoId/thumbnail. I file PNG vengono convertiti automaticamente in JPEG. L’immagine viene ridimensionata in varianti fino alla risoluzione del video. La risposta è l’oggetto video.

Il video deve essere già codificato (status è COMPLETE). Una richiesta per un video ancora in codifica, o per un video mancante, restituisce 400.

Il Content-Type deve essere multipart/form-data e non application/json.

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

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'
}
});

  $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'
    ]
  ]);

Risposta

L’immagine caricata viene ridimensionata automaticamente in più varianti di risoluzione. Vengono generate solo dimensioni uguali o inferiori all’immagine sorgente. La risposta è l’intero oggetto video.

• src.thumbnails viene sostituito con varianti multirisoluzione dell’immagine caricata.
• src.thumbnailUrl viene aggiornato alla variante 1080p (o alla variante più alta disponibile) della nuova miniatura.

{
  "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",
    ...
  },
  ...
}