Skip to Content
Referência APIVídeosThumbnailsCriar

Criar miniatura

Carregar imagem de miniatura

Para carregar uma miniatura personalizada, envia um pedido PUT com o campo multipart file, que contém um JPEG ou PNG, para o endpoint /videos/:videoId/thumbnail. Os ficheiros PNG são convertidos automaticamente para JPEG. A imagem é redimensionada em variantes até à resolução do vídeo. A resposta é o objeto de vídeo.

O vídeo já tem de estar codificado (status é COMPLETE). Um pedido para um vídeo que ainda está a ser codificado, ou para um vídeo em falta, devolve 400.

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 de vídeo 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