Skip to Content
Riferimento APIVideoThumbnailsCreare

Creare miniatura

Caricare l’immagine della miniatura

Per caricare una miniatura personalizzata si effettua inviando una richiesta PUT con dati del form che contengono un file JPEG o PNG (max 8 MB) all’endpoint /videos/:videoId/thumbnail. I file PNG vengono convertiti automaticamente in JPEG.

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]"

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

src.thumbnailUrl è deprecato e sarà rimosso in una versione futura. Usa src.thumbnails al suo posto.

Eliminare videoRipristinare