Créer une miniature

Téléchargement miniature

Pour télécharger une miniature personnalisée, envoie une requête PUT avec le champ multipart file contenant un JPEG ou un PNG à l’endpoint /videos/:videoId/thumbnail. Les fichiers PNG sont automatiquement convertis en JPEG. L’image est redimensionnée en variantes jusqu’à la résolution de la vidéo. La réponse est l’objet vidéo.

La vidéo doit déjà être encodée (status vaut COMPLETE). Une requête pour une vidéo encore en cours d’encodage, ou pour une vidéo manquante, renvoie 400.

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

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

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