Définir la couverture d'un Reel via l'API Instagram
L'API Instagram définit la couverture d'un Reel de deux façons à la création du conteneur : cover_url pointe vers une image JPEG utilisée comme couverture dans l'onglet Reels, ou thumb_offset choisit une image de la vidéo, en millisecondes depuis le début. Sans l'un ni l'autre, la première image est utilisée, et si les deux sont envoyés, cover_url l'emporte.
easyCoexistence publie des Reels avec publish_instagram_post depuis Claude, ChatGPT ou votre propre code.
Plus grande image de couverture de Reel ; elle doit être un JPEG, les autres espaces colorimétriques étant convertis en sRGB.
Format de couverture recommandé par Meta ; les autres formats sont recadrés sur leur rectangle central 9:16.
Le carré central que Meta découpe dans la couverture lorsque le Reel est partagé dans le fil d'actualité.
Valeur par défaut de thumb_offset, qui fait de la première image de la vidéo la vignette.
Sous-code d'erreur pour un thumb_offset inférieur à 0 ou égal ou supérieur à la durée de la vidéo.
Comment définir la couverture d'un Reel ?
Sur le conteneur du Reel. POST /<IG_ID>/media avec media_type REELS et video_url accepte aussi soit cover_url, l'URL publique d'une image que Meta récupère et utilise comme couverture dans l'onglet Reels, soit thumb_offset, la position en millisecondes de l'image à utiliser. La couverture appartient au conteneur, elle se choisit donc avant la publication du 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"
}Quelles sont les caractéristiques de l'image de couverture ?
Spécifications de Meta pour la photo de couverture d'un Reel, que l'image à cover_url doit respecter :
- Format : JPEG.
- Taille de fichier : jusqu'à 8 Mo.
- Espace colorimétrique : sRGB ; les images dans d'autres espaces sont converties.
- Ratio d'image : 9:16 recommandé, pour éviter le recadrage ou les espaces vides.
- Emplacement : un serveur public, car Meta récupère l'image à partir de l'URL elle-même.
Comment la couverture est-elle recadrée ?
Autour du centre. Lorsque l'image n'est pas en 9:16, Meta la recadre et utilise le rectangle central 9:16 comme couverture du Reel ; lorsque le Reel est partagé dans le fil d'actualité, le carré central 1:1 devient la couverture de la publication. Garder les visages et le texte près du centre permet aux deux recadrages de les montrer.
Comment fonctionne thumb_offset ?
Il désigne un moment de la vidéo, en millisecondes, dont l'image devient la vignette ; la valeur par défaut, 0, correspond à la première image. La valeur doit être supérieure ou égale à 0 et inférieure à la durée de la vidéo, sinon la requête échoue avec le code 1, sous-code 2207057. thumb_offset s'applique aussi aux conteneurs vidéo, et sur un Reel qui a aussi un cover_url, Meta l'ignore.
La couverture peut-elle être relue ou modifiée plus tard ?
Relue, oui : un Reel publié renvoie media_type VIDEO, et son champ thumbnail_url retourne l'image de vignette du média. La modification est une autre affaire, car la seule mise à jour documentée par Meta pour un média publié active ou désactive les commentaires. La couverture est donc fixée à la création du conteneur.
Erreurs courantes
- Envoyer cover_url et thumb_offset ensemble en espérant l'image choisie. Meta utilise cover_url et ignore thumb_offset.
- Donner thumb_offset en secondes. Il compte en millisecondes, et une valeur égale ou supérieure à la longueur de la vidéo échoue avec le sous-code 2207057.
- Téléverser une couverture en PNG. Une couverture de Reel doit être un JPEG d'au plus 8 Mo.
- Placer le sujet au bord de la couverture. Meta conserve le 9:16 central de l'image, et seulement le carré central dans le fil d'actualité.
L'outil n'accepte ni cover_url ni thumb_offset, donc le Reel sort avec l'image choisie par Instagram, et une autre couverture se choisit dans l'application Instagram. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours d'essai gratuit.
Questions fréquemment posées
Puis-je téléverser une couverture personnalisée pour un Reel via l'API ?
Oui. Passez cover_url avec l'URL publique d'un JPEG d'au plus 8 Mo lors de la création du conteneur du Reel.
Une couverture de Reel doit-elle être en sRGB ?
Il est conseillé de le faire. La spécification de Meta demande du sRGB et convertit les images dans d'autres espaces colorimétriques ; la couverture doit en tout cas être un JPEG d'au plus 8 Mo.
Que signifie l'erreur 2207057 sur un Reel Instagram ?
Le thumb_offset du Reel est hors plage, sous le code 1 : il doit être au moins égal à 0 et inférieur à la durée de la vidéo, exprimé en millisecondes, donc 5 secondes correspondent à 5000.
Que se passe-t-il si j'envoie à la fois cover_url et thumb_offset ?
Meta utilise l'image de cover_url et ignore thumb_offset.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le