Skip to Content
Référence APIVidéosThumbnailsCréer

Créer une miniature

Téléchargement miniature

Pour télécharger une miniature personnalisée, envoie une requête PUT avec des données de formulaire contenant un fichier JPEG ou PNG (max. 8 Mo) à l’endpoint /videos/:videoId/thumbnail. Les fichiers PNG sont automatiquement convertis en JPEG.

Le Content-Type doit être multipart/form-data et pas 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]"

Réponse

L’image téléchargée est automatiquement redimensionnée en plusieurs variantes de résolution. Seules les tailles inférieures ou égales à l’image source sont générées. La réponse est l’objet vidéo complet.

  • src.thumbnails est remplacé par des variantes multi-résolution de l’image téléchargée.
  • src.thumbnailUrl est mis à jour vers la variante 1080p (ou la plus haute disponible) de la nouvelle miniature.
{
  "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 est déprécié et sera retiré dans une version future. Utilise plutôt src.thumbnails.

Supprimer vidéoRéinitialiser