Definindo a capa de um Reel pela API do Instagram
A API do Instagram define a capa de um Reel de uma de duas formas ao criar o container: cover_url aponta para uma imagem JPEG usada como capa na aba Reels, ou thumb_offset escolhe um quadro do vídeo, em milissegundos desde o início. Sem nenhum dos dois, usa-se o primeiro quadro, 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.
Maior imagem de capa de Reels; deve ser JPEG, e outros espaços de cor são convertidos para sRGB.
Formato de capa recomendado pela Meta; outros formatos são cortados no retângulo 9:16 central.
O quadrado central que a Meta corta da capa quando o Reel é compartilhado no Feed.
thumb_offset padrão, que torna o primeiro quadro do vídeo a miniatura.
Subcódigo de erro para um thumb_offset menor que 0 ou não menor que a duração do vídeo.
Como definir a capa de um Reel?
No container do Reel. POST /<IG_ID>/media com media_type REELS e video_url também aceita cover_url, a URL pública de uma imagem que a Meta busca e usa como capa na aba Reels, ou thumb_offset, a posição em milissegundos do quadro a usar. A capa pertence ao container, então é 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 deve ser a imagem de capa?
A especificação da Meta para a foto de capa de um Reel, que a imagem em cover_url precisa atender:
- Formato: JPEG.
- Tamanho do arquivo: até 8 MB.
- Espaço de cor: sRGB; imagens em outros espaços de cor são convertidas.
- Proporção: 9:16 recomendada, para evitar cortes ou espaços em branco.
- Local: um servidor público, já que a Meta busca a imagem pela própria URL.
Como a capa é cortada?
Pelo centro. Quando a imagem não está em 9:16, a Meta a corta e usa o retângulo 9:16 central como capa do Reel; quando o Reel é compartilhado no Feed, o quadrado 1:1 central vira a capa da publicação no Feed. Manter rostos e textos próximos ao centro faz com que os dois cortes os mostrem.
Como funciona o thumb_offset?
Indica um momento do vídeo, em milissegundos, cujo quadro se torna a miniatura; o padrão, 0, é o primeiro quadro. O valor deve ser 0 ou maior e menor que a duração do vídeo, ou a requisição falha com código 1, subcódigo 2207057. O thumb_offset também se aplica a containers de vídeo, e em um Reel que também tem cover_url, a Meta o ignora.
A capa pode ser lida ou alterada depois?
Pode ser lida: um Reel publicado informa media_type VIDEO, e seu campo thumbnail_url retorna a imagem de miniatura da mídia. Alterá-la é outra questão, já que a única atualização que a Meta documenta para mídias publicadas liga ou desliga comentários, então a capa fica definida quando o container é criado.
Erros comuns
- Enviar cover_url e thumb_offset juntos e esperar o quadro. A Meta usa cover_url e ignora thumb_offset.
- Informar thumb_offset em segundos. Ele conta milissegundos, e um valor igual ou maior que a duração do vídeo falha com subcódigo 2207057.
- Enviar uma capa em PNG. A capa de Reels deve ser JPEG de até 8 MB.
- Posicionar o assunto na borda da capa. A Meta mantém o 9:16 central da imagem, e só o quadrado central no Feed.
A ferramenta não recebe cover_url nem thumb_offset, então o Reel sai com o quadro que o Instagram escolhe, e outra capa é escolhida no app do Instagram. De US$ 9 a US$ 0,75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Posso enviar uma capa personalizada para um Reel pela API?
Sim. Passe cover_url com a URL pública de uma JPEG de até 8 MB ao criar o container do Reel.
A capa de um Reel precisa ser sRGB?
Deveria. A especificação da Meta pede sRGB e converte imagens em outros espaços de cor, e a capa precisa ser uma JPEG de até 8 MB.
O que significa o erro 2207057 em um Reel do Instagram?
O thumb_offset do Reel está fora do intervalo, sob o código 1: ele deve ser pelo menos 0 e menor que a duração do vídeo, contado em milissegundos, então 5 segundos depois é 5000.
E se eu enviar cover_url e thumb_offset juntos?
A Meta usa a imagem de cover_url e ignora thumb_offset.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em