Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Setarea copertei unui Reel prin API-ul Instagram

API-ul Instagram setează coperta unui Reel în una din două moduri la crearea containerului: cover_url indică o imagine JPEG folosită ca primă copertă în fila Reels, iar thumb_offset alege un cadru din video, în milisecunde de la început. Fără niciunul, se folosește primul cadru, iar dacă sunt trimise ambele, cover_url are prioritate.

easyCoexistence publică Reels cu publish_instagram_post din Claude, ChatGPT sau din propriul cod.

8 MB

Cea mai mare copertă pentru Reels; trebuie să fie JPEG, iar celelalte spații de culoare se convertesc în sRGB.

9:16

Forma de copertă recomandată de Meta; celelalte forme se decupează în dreptunghiul central de 9:16.

1:1

Pătratul central pe care Meta îl decupează din copertă atunci când Reel-ul se distribuie în Feed.

0 ms

thumb_offset implicit, care face din primul cadru al videoclipului miniatura.

2207057

Subcodul de eroare pentru un thumb_offset mai mic decât 0 sau nu mai scurt decât durata videoclipului.

Cum se setează coperta unui Reel?

Pe containerul Reel-ului. POST /<IG_ID>/media cu media_type REELS și video_url acceptă fie cover_url, adresa publică a unei imagini pe care Meta o preia și o folosește drept copertă în fila Reels, fie thumb_offset, poziția în milisecunde a cadrului de folosit. Coperta aparține containerului, deci se alege înainte ca Reel-ul să fie publicat.

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

Ce trebuie să fie imaginea de copertă?

Specificația Meta pentru o fotografie de copertă Reels, pe care trebuie să o îndeplinească imaginea de la cover_url:

  • Format: JPEG.
  • Dimensiunea fișierului: până la 8 MB.
  • Spațiu de culoare: sRGB; imaginile în alte spații de culoare se convertesc.
  • Raport de aspect: recomandat 9:16, pentru a evita decuparea sau spațiul gol.
  • Locație: un server public, deoarece Meta preia imaginea direct de la URL.

Cum se decupează coperta?

În jurul centrului. Când imaginea nu are raportul 9:16, Meta o decupează și folosește dreptunghiul central 9:16 drept copertă a Reel-ului, iar atunci când Reel-ul se distribuie în Feed, pătratul central 1:1 devine copertă a postării din Feed. Dacă fețele și textul sunt aproape de centru, ambele decupări le arată.

Cum funcționează thumb_offset?

Indică un moment din video, în milisecunde, al cărui cadru devine miniatura; valoarea implicită, 0, este primul cadru. Valoarea trebuie să fie 0 sau mai mare și mai mică decât durata videoclipului, altfel cererea eșuează cu codul 1, subcodul 2207057. thumb_offset se aplică și containerelor video, iar la un Reel care are și cover_url, Meta îl ignoră.

Poate fi citită sau schimbată coperta ulterior?

Poate fi citită: un Reel publicat raportează media_type VIDEO, iar câmpul thumbnail_url returnează imaginea miniaturii media. Schimbarea este altceva, deoarece singura actualizare documentată de Meta pentru media publicată activează sau dezactivează comentariile, așa că starea copertei se stabilește la crearea containerului.

Greșeli frecvente

  • Trimiterea simultană a cover_url și thumb_offset cu așteptarea unui cadru. Meta folosește cover_url și ignoră thumb_offset.
  • Transmiterea thumb_offset în secunde. Valoarea se numără în milisecunde, iar o valoare egală sau mai mare decât durata videoclipului eșuează cu subcodul 2207057.
  • Încărcarea unei coperte PNG. Coperta pentru Reels trebuie să fie JPEG de până la 8 MB.
  • Plasarea subiectului la marginea copertei. Meta păstrează dreptunghiul central 9:16 al imaginii și, în Feed, doar pătratul central.
Faceți acest lucru cu EasyCoexistence

Unealta nu acceptă cover_url sau thumb_offset, așa că Reel-ul pleacă cu cadrul ales de Instagram, iar altă copertă se alege în aplicația Instagram. US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu perioadă de probă gratuită de 3 zile.

Întrebări frecvente

Pot încărca o copertă personalizată pentru un Reel prin API?

Da. Transmiteți cover_url cu adresa publică a unui JPEG de până la 8 MB la crearea containerului Reel-ului.

Coperta unui Reel trebuie să fie sRGB?

Ar trebui. Specificația Meta cere sRGB și convertește imaginile din alte spații de culoare, iar coperta trebuie să fie un JPEG de până la 8 MB.

Ce înseamnă eroarea 2207057 la un Reel Instagram?

Înseamnă că thumb_offset al Reel-ului este în afara intervalului, sub codul 1: trebuie să fie cel puțin 0 și mai mic decât durata videoclipului, numărată în milisecunde, deci 5 secunde corespund valorii 5000.

Ce se întâmplă dacă trimit atât cover_url, cât și thumb_offset?

Meta folosește imaginea cover_url și ignoră thumb_offset.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la