Skip to Content
Referência APIVídeosThumbnailsCriar

Criar miniatura

Carregar imagem de miniatura

Para carregar uma miniatura personalizada, envia um pedido PUT com dados de formulário que incluam um ficheiro JPEG ou PNG (máx. 8 MB) para o endpoint /videos/:videoId/thumbnail. Os ficheiros PNG são convertidos automaticamente para JPEG.

O Content-Type tem de ser multipart/form-data e não 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]"

Resposta

A imagem carregada é redimensionada automaticamente em várias variantes de resolução. Só são gerados tamanhos iguais ou inferiores à imagem de origem. A resposta é o objeto Video completo.

  • src.thumbnails é substituído por variantes multi-resolução da imagem carregada.
  • src.thumbnailUrl é atualizado para a variante 1080p (ou a variante mais alta disponível) da nova 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á descontinuado e será removido numa versão futura. Usa src.thumbnails em alternativa.

Eliminar vídeoRepor