InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Een Reel-omslagafbeelding instellen via de Instagram API

De Instagram API stelt de omslag van een Reel op een van twee manieren in wanneer de container wordt aangemaakt: cover_url wijst naar een JPEG die als omslag op het Reels-tabblad wordt gebruikt, of thumb_offset kiest een frame uit de video, in milliseconden vanaf het begin. Zonder beide wordt het eerste frame gebruikt, en als beide worden meegestuurd, wint cover_url.

easyCoexistence publiceert Reels met publish_instagram_post vanuit Claude, ChatGPT of je eigen code.

8 MB

Grootste omslagafbeelding voor Reels; moet een JPEG zijn, andere kleurruimtes worden omgezet naar sRGB.

9:16

Omslagvorm die Meta aanbeveelt; andere vormen worden bijgesneden tot hun middelste 9:16-rechthoek.

1:1

Het middelste vierkant dat Meta uit de omslag snijdt wanneer de Reel naar de Feed wordt gedeeld.

0 ms

Standaardwaarde van thumb_offset, waardoor het eerste frame van de video de thumbnail wordt.

2207057

Foutsubcode voor een thumb_offset onder 0 of niet korter dan de duur van de video.

Hoe stel je de omslag van een Reel in?

Op de container van de Reel. POST /<IG_ID>/media met media_type REELS en video_url accepteert ook cover_url, de openbare URL van een afbeelding die Meta ophaalt en als omslag op het Reels-tabblad gebruikt, of thumb_offset, de positie in milliseconden van het gekozen frame. De omslag hoort bij de container, dus wordt die gekozen voordat de Reel wordt gepubliceerd.

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

Aan welke eisen moet de omslagafbeelding voldoen?

De specificatie van Meta voor een omslagfoto van een Reel, waaraan de afbeelding op cover_url moet voldoen:

  • Formaat: JPEG.
  • Bestandsgrootte: maximaal 8 MB.
  • Kleurruimte: sRGB; afbeeldingen in andere kleurruimtes worden omgezet.
  • Beeldverhouding: 9:16 aanbevolen, om bijsnijden of lege ruimte te voorkomen.
  • Locatie: een openbare server, omdat Meta de afbeelding zelf via de URL ophaalt.

Hoe wordt de omslag bijgesneden?

Rond het midden. Als de afbeelding niet 9:16 is, snijdt Meta deze bij en gebruikt de middelste 9:16-rechthoek als omslag van de Reel. Wanneer de Reel naar de Feed wordt gedeeld, wordt het middelste vierkant van 1:1 de omslag van de Feed-post. Gezichten en tekst dicht bij het midden houden, laat beide uitsnedes ze tonen.

Hoe werkt thumb_offset?

Het benoemt een moment in de video, in milliseconden, waarvan het frame de thumbnail wordt; de standaardwaarde, 0, is het eerste frame. De waarde moet 0 of hoger zijn en kleiner dan de duur van de video, anders mislukt het verzoek met code 1, subcode 2207057. thumb_offset geldt ook voor videocontainers, en bij een Reel die ook cover_url heeft, negeert Meta het.

Kan de omslag later worden uitgelezen of gewijzigd?

Uitlezen wel: een gepubliceerde Reel meldt media_type VIDEO, en het veld thumbnail_url geeft de thumbnailafbeelding van de media terug. Wijzigen is een ander verhaal, want de enige update die Meta voor gepubliceerde media documenteert, zet reacties aan of uit. De omslag ligt dus vast zodra de container wordt aangemaakt.

Veelgemaakte fouten

  • cover_url en thumb_offset samen meesturen en het frame verwachten. Meta gebruikt cover_url en negeert thumb_offset.
  • thumb_offset in seconden opgeven. Het telt milliseconden, en een waarde op of na de lengte van de video mislukt met subcode 2207057.
  • Een PNG als omslag uploaden. Een omslag voor Reels moet een JPEG van maximaal 8 MB zijn.
  • Het onderwerp aan de rand van de omslag plaatsen. Meta behoudt het middelste 9:16 van de afbeelding, en in de Feed alleen het middelste vierkant.
Dit doen met EasyCoexistence

De tool neemt geen cover_url of thumb_offset aan, dus de Reel gaat uit met het beeld dat Instagram kiest, en een andere omslag kies je in de Instagram-app. Van US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.

Veelgestelde vragen

Kan ik een eigen omslag voor een Reel via de API uploaden?

Ja. Geef bij het aanmaken van de container van de Reel cover_url mee, met de openbare URL van een JPEG van maximaal 8 MB.

Moet een omslag voor een Reel sRGB zijn?

Dat is aan te raden. De specificatie van Meta vraagt om sRGB en zet afbeeldingen in andere kleurruimtes om, en de omslag moet een JPEG van maximaal 8 MB zijn.

Wat betekent foutsubcode 2207057 bij een Instagram Reel?

De thumb_offset van de Reel valt buiten het bereik, onder code 1: die moet minimaal 0 zijn en kleiner dan de duur van de video, in milliseconden, dus 5 seconden na het begin is 5000.

Wat gebeurt er als ik zowel cover_url als thumb_offset meestuur?

Meta gebruikt de afbeelding van cover_url en negeert thumb_offset.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op