Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

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.

8 MB

Plus grande image de couverture de Reel ; elle doit être un JPEG, les autres espaces colorimétriques étant convertis en sRGB.

9:16

Format de couverture recommandé par Meta ; les autres formats sont recadrés sur leur rectangle central 9:16.

1:1

Le carré central que Meta découpe dans la couverture lorsque le Reel est partagé dans le fil d'actualité.

0 ms

Valeur par défaut de thumb_offset, qui fait de la première image de la vidéo la vignette.

2207057

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.

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

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é.
Faire cela avec EasyCoexistence

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