Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Definir a capa de um Reel através da API do Instagram

A API do Instagram define a capa de um Reel de uma de duas formas ao criar o contentor: cover_url aponta para uma imagem JPEG a usar como capa no separador Reels, ou thumb_offset escolhe um fotograma do vídeo, em milissegundos a contar do início. Sem nenhum dos dois, usa-se o primeiro fotograma, e quando ambos são enviados, cover_url prevalece.

A easyCoexistence publica Reels com publish_instagram_post a partir do Claude, do ChatGPT ou do seu próprio código.

8 MB

Capa de Reels de maior tamanho; tem de ser JPEG, e os outros espaços de cor são convertidos para sRGB.

9:16

Formato de capa recomendado pela Meta; os outros formatos são recortados ao seu retângulo central 9:16.

1:1

O quadrado central que a Meta recorta da capa quando o Reel é partilhado no Feed.

0 ms

thumb_offset por omissão, que torna o primeiro fotograma do vídeo na miniatura.

2207057

Subcódigo de erro para um thumb_offset inferior a 0 ou não inferior à duração do vídeo.

Como se define a capa de um Reel?

No contentor do Reel. POST /<IG_ID>/media com media_type REELS e video_url aceita também cover_url, o URL público de uma imagem que a Meta obtém e usa como capa no separador Reels, ou thumb_offset, a posição em milissegundos do fotograma a usar. A capa pertence ao contentor, por isso é escolhida antes de o Reel ser publicado.

A Reel container with its own cover
POST https://graph.instagram.com/<IG_ID>/media
Content-Type: application/json

{
  "media_type": "REELS",
  "video_url": "https://example.com/reel.mp4",
  "caption": "<CAPTION>",
  "cover_url": "https://example.com/cover.jpg"
}

Como tem de ser a imagem da capa?

A especificação da Meta para a foto de capa de um Reel, que a imagem em cover_url tem de cumprir:

  • Formato: JPEG.
  • Tamanho do ficheiro: até 8 MB.
  • Espaço de cor: sRGB; as imagens noutros espaços de cor são convertidas.
  • Proporção: 9:16 recomendada, para evitar recortes ou espaço em branco.
  • Localização: um servidor público, uma vez que a Meta obtém a imagem a partir do URL.

Como é feito o recorte da capa?

Em torno do centro. Quando a imagem não está em 9:16, a Meta recorta-a e usa o retângulo central 9:16 como capa do Reel; quando o Reel é partilhado no Feed, o quadrado central 1:1 passa a ser a capa da publicação no Feed. Manter rostos e texto perto do centro faz com que ambos os recortes os mostrem.

Como funciona o thumb_offset?

Indica um momento do vídeo, em milissegundos, cujo fotograma se torna a miniatura; o valor por omissão, 0, é o primeiro fotograma. O valor tem de ser 0 ou superior e inferior à duração do vídeo, ou o pedido falha com código 1, subcódigo 2207057. O thumb_offset aplica-se também a contentores de vídeo, e num Reel que também tenha cover_url, a Meta ignora-o.

A capa pode ser lida ou alterada depois?

Sim, pode ser lida: um Reel publicado devolve media_type VIDEO, e o campo thumbnail_url devolve a imagem de miniatura do media. Alterá-la é outra questão, já que a única atualização que a Meta documenta para media publicado ativa ou desativa os comentários, pelo que a capa fica definida ao criar o contentor.

Erros comuns

  • Enviar cover_url e thumb_offset em conjunto e esperar o fotograma. A Meta usa cover_url e ignora thumb_offset.
  • Indicar thumb_offset em segundos. Conta milissegundos, e um valor igual ou superior à duração do vídeo falha com o subcódigo 2207057.
  • Carregar uma capa em PNG. A capa de um Reel tem de ser um JPEG até 8 MB.
  • Colocar o sujeito na margem da capa. A Meta mantém o 9:16 central da imagem, e só o quadrado central no Feed.
Fazer isto com a EasyCoexistence

A ferramenta não aceita cover_url nem thumb_offset, pelo que o Reel sai com o fotograma que o Instagram escolhe, e outra capa é escolhida na app do Instagram. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

Posso carregar uma capa personalizada para um Reel através da API?

Sim. Indique cover_url com o URL público de um JPEG até 8 MB ao criar o contentor do Reel.

A capa de um Reel tem de ser sRGB?

Deve ser. A especificação da Meta pede sRGB e converte as imagens noutros espaços de cor, e a capa tem de ser um JPEG até 8 MB.

O que significa o erro 2207057 num Reel do Instagram?

O thumb_offset do Reel está fora do intervalo, sob o código 1: tem de ser pelo menos 0 e inferior à duração do vídeo, contada em milissegundos, por isso 5 segundos após o início é 5000.

E se enviar cover_url e thumb_offset em conjunto?

A Meta usa a imagem de cover_url e ignora thumb_offset.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em