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.
La copertina Reels più grande; deve essere un JPEG, e gli altri spazi colore vengono convertiti in sRGB.
Formato di copertina raccomandato da Meta; gli altri formati vengono ritagliati sul rettangolo centrale 9:16.
Il quadrato centrale che Meta ritaglia dalla copertina quando il Reel viene condiviso nel feed.
thumb_offset predefinito, che rende il primo fotogramma del video la miniatura.
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.
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.
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