AccediInizia la prova gratuita
easyCoexistence API ufficiali

Impostare la copertina di un Reel tramite l'API di Instagram

L'API di Instagram imposta la copertina di un Reel in uno di due modi al momento della creazione del container: cover_url punta a un'immagine JPEG da usare come copertina nella scheda Reels, oppure thumb_offset sceglie un fotogramma del video, in millisecondi dall'inizio. Senza nessuno dei due si usa il primo fotogramma, e se vengono inviati entrambi vince cover_url.

easyCoexistence pubblica i Reel con publish_instagram_post da Claude, ChatGPT o dal tuo codice.

8 MB

La copertina Reels più grande; deve essere un JPEG, e gli altri spazi colore vengono convertiti in sRGB.

9:16

Formato di copertina raccomandato da Meta; gli altri formati vengono ritagliati sul rettangolo centrale 9:16.

1:1

Il quadrato centrale che Meta ritaglia dalla copertina quando il Reel viene condiviso nel feed.

0 ms

thumb_offset predefinito, che rende il primo fotogramma del video la miniatura.

2207057

Sottocodice di errore per un thumb_offset inferiore a 0 o non minore della durata del video.

Come si imposta la copertina di un Reel?

Sul container del Reel. POST /<IG_ID>/media con media_type REELS e video_url accetta anche cover_url, l'URL pubblico di un'immagine che Meta scarica e usa come copertina nella scheda Reels, oppure thumb_offset, la posizione in millisecondi del fotogramma da usare. La copertina appartiene al container, quindi va scelta prima della pubblicazione del Reel.

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"
}

Come deve essere l'immagine di copertina?

Le specifiche di Meta per la foto di copertina di un Reel, che l'immagine all'indirizzo cover_url deve rispettare:

  • Formato: JPEG.
  • Dimensione del file: fino a 8 MB.
  • Spazio colore: sRGB; le immagini in altri spazi colore vengono convertite.
  • Proporzioni: 9:16 consigliato, per evitare ritagli o spazi vuoti.
  • Posizione: un server pubblico, perché Meta scarica l'immagine direttamente dall'URL.

Come viene ritagliata la copertina?

Al centro. Quando l'immagine non è 9:16, Meta la ritaglia e usa il rettangolo centrale 9:16 come copertina del Reel; quando il Reel viene condiviso nel feed, il quadrato centrale 1:1 diventa la copertina del post nel feed. Tenere volti e testo vicini al centro fa sì che entrambi i ritagli li mostrino.

Come funziona thumb_offset?

Indica un momento del video, in millisecondi, il cui fotogramma diventa la miniatura; il valore predefinito, 0, è il primo fotogramma. Il valore deve essere 0 o maggiore e minore della durata del video, altrimenti la richiesta fallisce con codice 1, sottocodice 2207057. thumb_offset vale anche per i container video, e su un Reel che ha anche cover_url, Meta lo ignora.

La copertina può essere letta o modificata in seguito?

Leggerla sì: un Reel pubblicato riporta media_type VIDEO, e il suo campo thumbnail_url restituisce l'immagine di miniatura del media. Modificarla è un'altra questione, perché l'unico aggiornamento documentato da Meta per i media pubblicati attiva o disattiva i commenti, quindi la copertina è definita alla creazione del container.

Errori comuni

  • Inviare cover_url e thumb_offset insieme aspettandosi il fotogramma. Meta usa cover_url e ignora thumb_offset.
  • Indicare thumb_offset in secondi. Conta i millisecondi, e un valore pari o superiore alla durata del video fallisce con il sottocodice 2207057.
  • Caricare una copertina in PNG. La copertina di un Reel deve essere un JPEG fino a 8 MB.
  • Mettere il soggetto al bordo della copertina. Meta conserva il 9:16 centrale dell'immagine, e nel feed solo il quadrato centrale.
Farlo con EasyCoexistence

Lo strumento non accetta cover_url né thumb_offset, quindi il Reel esce con il fotogramma scelto da Instagram, e un'altra copertina si sceglie nell'app di Instagram. Da US$ 9 a US$ 0.75 per connessione al mese, in calo man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.

Domande frequenti

Posso caricare una copertina personalizzata per un Reel tramite API?

Sì. Passa cover_url con l'URL pubblico di un JPEG fino a 8 MB quando crei il container del Reel.

La copertina di un Reel deve essere in sRGB?

Dovrebbe esserlo. Le specifiche di Meta lo richiedono e convertono le immagini in altri spazi colore; la copertina deve comunque essere un JPEG fino a 8 MB.

Cosa significa l'errore 2207057 su un Reel Instagram?

Il thumb_offset del Reel è fuori intervallo, sotto il codice 1: deve essere almeno 0 e minore della durata del video, espresso in millisecondi, quindi 5 secondi dall'inizio sono 5000.

Cosa succede se invio sia cover_url sia thumb_offset?

Meta usa l'immagine di cover_url e ignora thumb_offset.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il