Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Reelin kansikuvan asettaminen Instagram-rajapinnan kautta

Instagramin API asettaa Reelin kansikuvan containerin luonnin yhteydessä kahdella tavalla: cover_url osoittaa JPEG-kuvaan, jota käytetään Reels-välilehden kansikuvana, tai thumb_offset valitsee videon kehyksen millisekunneissa alusta laskien. Jos kumpikaan ei ole mukana, käytetään ensimmäistä kehystä. Jos molemmat lähetetään, cover_url voittaa.

easyCoexistence julkaisee Reelejä publish_instagram_post-työkalulla Claudesta, ChatGPT:stä tai omasta koodistasi.

8 MB

Suurin Reelsin kansikuva. Sen on oltava JPEG-muotoinen, ja muut väriavaruudet muunnetaan sRGB:hen.

9:16

Metan suosittama kansikuvan muoto. Muut muodot rajataan keskimmäiseen 9:16-suorakulmioon.

1:1

Keskimmäinen neliö, jonka Meta rajaa kannesta, kun Reel jaetaan Feed-syötteeseen.

0 ms

Oletusarvo thumb_offset, joka tekee videon ensimmäisestä kehyksestä pikkukuvan.

2207057

Virheen alikoodi, kun thumb_offset on alle 0 tai ei ole lyhyempi kuin videon kesto.

Miten Reelin kansikuva asetetaan?

Reelin containerissa. POST /<IG_ID>/media, jossa media_type on REELS ja video_url, ottaa myös vastaan joko cover_url:n, eli Metan hakeman ja Reels-välilehden kansikuvana käyttämän kuvan julkisen URL-osoitteen, tai thumb_offset:n, eli käytettävän kehyksen sijainnin millisekunneina. Kansikuva kuuluu containeriin, joten se valitaan ennen Reelin julkaisemista.

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

Millainen kansikuvan pitää olla?

Metan Reels-kansikuvan vaatimukset, jotka cover_url-kuvan on täytettävä:

  • Muoto: JPEG.
  • Tiedostokoko: enintään 8 MB.
  • Väriavaruus: sRGB. Muissa väriavaruuksissa olevat kuvat muunnetaan.
  • Kuvasuhde: suositellaan 9:16, jotta leikkautumista tai tyhjää tilaa ei synny.
  • Sijainti: julkinen palvelin, koska Meta hakee kuvan suoraan URL-osoitteesta.

Miten kansikuva rajataan?

Keskeltä. Kun kuva ei ole 9:16, Meta rajaa sen ja käyttää keskimmäistä 9:16-suorakulmiota Reelin kansikuvana. Kun Reel jaetaan Feed-syötteeseen, keskimmäisestä 1:1-neliöstä tulee Feed-julkaisun kansikuva. Kasvot ja teksti kannattaa pitää lähellä keskustaa, jotta molemmat rajaukset näyttävät ne.

Miten thumb_offset toimii?

Se nimeää hetken videossa millisekunneissa, ja sen kehys tulee pikkukuvaksi. Oletusarvo 0 tarkoittaa ensimmäistä kehystä. Arvon on oltava vähintään 0 ja pienempi kuin videon kesto, muuten pyyntö epäonnistuu koodilla 1, alikoodilla 2207057. thumb_offset toimii myös videocontainereissa, ja jos Reelillä on myös cover_url, Meta jättää sen huomiotta.

Voiko kansikuvan lukea tai vaihtaa myöhemmin?

Lukea voi: julkaistu Reel ilmoittaa media_type-arvoksi VIDEO, ja sen thumbnail_url-kenttä palauttaa median pikkukuvan. Vaihtaminen on eri asia, sillä ainoa päivitys, jonka Meta dokumentoi julkaistulle medialle, on kommenttien kytkeminen päälle tai pois. Kansikuva lukitaan siis containerin luonnissa.

Yleiset virheet

  • Lähetät cover_url- ja thumb_offset-kentät yhdessä ja odotat kehystä. Meta käyttää cover_url-kenttää ja jättää thumb_offset-kentän huomiotta.
  • Annat thumb_offset-arvon sekunteina. Kenttä lasketaan millisekunteina, ja arvo, joka on videon pituuden kohdalla tai sen yli, epäonnistuu alikoodilla 2207057.
  • Lataat PNG-kansikuvan. Reelsin kansikuvan on oltava JPEG-kuva, jonka koko on enintään 8 MB.
  • Kohteen asettaminen kannen reunaan. Meta säilyttää kuvan keskimmäisen 9:16-alueen, ja Feed-syötteessä vain keskimmäisen neliön.
Näin teet tämän EasyCoexistencen avulla

Työkalu ei ota cover_url- eikä thumb_offset-kenttää, joten Reel julkaistaan Instagramin valitsemalla kuvalla, ja toinen kansikuva valitaan Instagram-sovelluksessa. US$ 9:stä US$ 0.75:een per yhteys kuukaudessa, hinta laskee yhteyksien lisääntyessä, ensimmäiset 3 päivää ilmaiseksi.

Usein kysytyt kysymykset

Voinko lähettää oman kansikuvan Reelille API:n kautta?

Kyllä. Anna cover_url, eli julkinen URL-osoite JPEG-kuvaan, joka on enintään 8 MB, kun luot Reelin containerin.

Pitääkö Reelin kansikuvan olla sRGB-muodossa?

Sen pitäisi olla. Metan määrityksessä vaaditaan sRGB, ja muut väriavaruudet muunnetaan. Kansikuvan on oltava JPEG, enintään 8 MB.

Mitä virhe 2207057 tarkoittaa Instagram-Reelissä?

Reelin thumb_offset on alueen ulkopuolella koodin 1 alla: arvon on oltava vähintään 0 ja pienempi kuin videon kesto millisekunteina, eli 5 sekunnin kohta on 5000.

Mitä tapahtuu, jos lähetän sekä cover_url- että thumb_offset-kentän?

Meta käyttää cover_url-kuvaa ja jättää thumb_offset-kentän huomiotta.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu