Crear miniatura

Subir imagen de miniatura

Subir una miniatura personalizada se hace enviando una solicitud PUT con el campo multipart file, que contiene un JPEG o un PNG, al endpoint /videos/:videoId/thumbnail. Los archivos PNG se convierten automáticamente a JPEG. La imagen se redimensiona a variantes hasta la resolución del video. La respuesta es el objeto de video.

El video ya debe estar codificado (status es COMPLETE). Una solicitud para un video que aún se está codificando, o para un video inexistente, devuelve 400.

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

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