Crear miniatura

Subir imagen de miniatura

Subir una miniatura personalizada se hace enviando una solicitud PUT con datos de formulario que contengan un archivo JPEG o PNG (máx. 8 MB) al endpoint /videos/:videoId/thumbnail. Los archivos PNG se convierten automáticamente a JPEG.

El Content-Type tiene que ser multipart/form-data y no 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'
    ]
  ]);

Respuesta

La imagen subida se redimensiona automáticamente en varias variantes de resolución. Solo se generan tamaños iguales o menores que la imagen de origen. La respuesta es el objeto de video completo.

src.thumbnails se sustituye por variantes multiresolución de la imagen subida.
src.thumbnailUrl se actualiza a la variante 1080p (o la variante más alta disponible) de la nueva 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 está deprecado y se eliminará en una versión futura. Usa src.thumbnails en su lugar.