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.
Capa de Reels de maior tamanho; tem de ser JPEG, e os outros espaços de cor são convertidos para sRGB.
Formato de capa recomendado pela Meta; os outros formatos são recortados ao seu retângulo central 9:16.
O quadrado central que a Meta recorta da capa quando o Reel é partilhado no Feed.
thumb_offset por omissão, que torna o primeiro fotograma do vídeo na miniatura.
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.
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.
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