EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

8 MB

Maior imagem de capa de Reels; deve ser JPEG, e outros espaços de cor são convertidos para sRGB.

9:16

Formato de capa recomendado pela Meta; outros formatos são cortados no retângulo 9:16 central.

1:1

O quadrado central que a Meta corta da capa quando o Reel é compartilhado no Feed.

0 ms

thumb_offset padrão, que torna o primeiro quadro do vídeo a miniatura.

2207057

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.

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 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.
Fazendo isso com o EasyCoexistence

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