Das Titelbild eines Reels über die Instagram API festlegen
Die Instagram API legt das Titelbild eines Reels beim Erstellen des Containers auf eine von zwei Arten fest: cover_url verweist auf ein JPEG, das als Titelbild im Reels-Tab dient, oder thumb_offset wählt ein Einzelbild des Videos in Millisekunden ab dem Anfang. Ohne beides wird das erste Einzelbild verwendet, und werden beide gesendet, gewinnt cover_url.
easyCoexistence veröffentlicht Reels mit publish_instagram_post aus Claude, ChatGPT oder eigenem Code.
Größtes Titelbild für Reels; es muss ein JPEG sein, andere Farbräume werden in sRGB umgewandelt.
Von Meta empfohlenes Titelformat; andere Formate werden auf ihr mittleres 9:16-Rechteck zugeschnitten.
Das mittlere Quadrat, das Meta vom Titelbild abschneidet, wenn das Reel im Feed geteilt wird.
Standardwert von thumb_offset, der das erste Einzelbild des Videos zum Vorschaubild macht.
Fehler-Subcode für einen thumb_offset unter 0 oder nicht kürzer als die Videodauer.
Wie legt man das Titelbild eines Reels fest?
Am Container des Reels. POST /<IG_ID>/media mit media_type REELS und video_url nimmt außerdem entweder cover_url, die öffentliche URL eines Bildes, das Meta abruft und als Titelbild im Reels-Tab verwendet, oder thumb_offset, die Position des gewünschten Einzelbildes in Millisekunden. Das Titelbild gehört zum Container und wird daher festgelegt, bevor das Reel veröffentlicht wird.
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"
}Wie muss das Titelbild beschaffen sein?
Metas Spezifikation für ein Reels-Titelfoto, der das Bild unter cover_url entsprechen muss:
- Format: JPEG.
- Dateigröße: bis zu 8 MB.
- Farbraum: sRGB; Bilder in anderen Farbräumen werden umgewandelt.
- Seitenverhältnis: 9:16 empfohlen, um Zuschnitt oder leere Flächen zu vermeiden.
- Ort: ein öffentlicher Server, da Meta das Bild selbst über die URL abruft.
Wie wird das Titelbild zugeschnitten?
Um die Mitte. Ist das Bild nicht 9:16, schneidet Meta es zu und verwendet das mittlere 9:16-Rechteck als Titelbild des Reels. Wird das Reel im Feed geteilt, wird das mittlere 1:1-Quadrat zum Titelbild des Feed-Beitrags. Gesichter und Text nahe der Mitte zu platzieren, sorgt dafür, dass sie in beiden Zuschnitten sichtbar bleiben.
Wie funktioniert thumb_offset?
Es benennt einen Zeitpunkt im Video in Millisekunden, dessen Einzelbild zum Vorschaubild wird; der Standardwert 0 ist das erste Einzelbild. Der Wert muss 0 oder größer und kleiner als die Videodauer sein, sonst schlägt die Anfrage mit Code 1, Subcode 2207057 fehl. thumb_offset gilt auch für Video-Container, und bei einem Reel, das außerdem cover_url hat, ignoriert Meta es.
Kann das Titelbild später ausgelesen oder geändert werden?
Auslesen ja: Ein veröffentlichtes Reel meldet media_type VIDEO, und sein Feld thumbnail_url liefert das Vorschaubild des Mediums. Ändern ist eine andere Sache, denn das einzige Update, das Meta für veröffentlichte Medien dokumentiert, schaltet Kommentare ein oder aus. Das Titelbild steht daher fest, sobald der Container erstellt ist.
Häufige Fehler
- cover_url und thumb_offset gemeinsam senden und den Frame erwarten. Meta verwendet cover_url und ignoriert thumb_offset.
- thumb_offset in Sekunden angeben. Gezählt werden Millisekunden, und ein Wert am oder über der Videolänge schlägt mit Subcode 2207057 fehl.
- Ein PNG als Titelbild hochladen. Ein Reels-Titelbild muss ein JPEG mit bis zu 8 MB sein.
- Das Motiv an den Rand des Titelbildes setzen. Meta behält die mittleren 9:16 des Bildes und im Feed nur das mittlere Quadrat.
Das Tool nimmt weder cover_url noch thumb_offset an, daher geht das Reel mit dem Frame hinaus, den Instagram auswählt, und ein anderes Titelbild wird in der Instagram-App gewählt. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit 3 Tagen kostenloser Testphase.
Häufig gestellte Fragen
Kann ich für ein Reel ein eigenes Titelbild über die API hochladen?
Ja. Übergeben Sie beim Erstellen des Containers des Reels cover_url mit der öffentlichen URL eines JPEG mit bis zu 8 MB.
Muss das Reels-Titelbild sRGB sein?
Es sollte so sein. Metas Spezifikation verlangt sRGB und wandelt Bilder in anderen Farbräumen um; das Titelbild muss zudem ein JPEG mit bis zu 8 MB sein.
Was bedeutet Fehler 2207057 bei einem Instagram-Reel?
Der thumb_offset des Reels liegt außerhalb des Bereichs, unter Code 1: Er muss mindestens 0 und kleiner als die Videodauer sein, in Millisekunden gezählt, also entsprechen 5 Sekunden ab Anfang dem Wert 5000.
Was passiert, wenn ich sowohl cover_url als auch thumb_offset sende?
Meta verwendet das Bild aus cover_url und ignoriert thumb_offset.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am