Instagram API でリールのカバー画像を設定する
Instagram API では、コンテナの作成時にリールのカバーを 2 通りの方法で設定できます。cover_url はリールタブのカバーに使う JPEG 画像の URL を指定し、thumb_offset は動画の先頭から何ミリ秒後のフレームを使うかを指定します。どちらも指定しない場合は先頭フレームが使われ、両方を送ると cover_url が優先されます。
easyCoexistence は、Claude、ChatGPT、または独自のコードから publish_instagram_post を使ってリールを公開できます。
リールのカバー画像で最大のサイズです。JPEG である必要があり、ほかの色空間は sRGB に変換されます。
Meta が推奨するカバーの形状です。ほかの形状は中央の 9:16 の長方形に切り抜かれます。
リールをフィードに共有するときに、Meta がカバーから切り抜く中央の正方形です。
動画の先頭フレームをサムネイルにする、thumb_offset の既定値です。
thumb_offset が 0 未満、または動画の長さ以上の場合のエラーサブコードです。
リールのカバーはどう設定しますか?
コンテナに対して設定します。POST /<IG_ID>/media で media_type に REELS を指定し、video_url を送るときに、cover_url か thumb_offset のどちらかを指定できます。cover_url は、リールタブのカバーとして Meta が取得して使う画像の公開 URL です。thumb_offset は、使用するフレームの位置をミリ秒で指定します。カバーはコンテナに属するため、リールを公開する前に選択します。
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"
}カバー画像はどのような条件を満たす必要がありますか?
cover_url で指定する画像は、Meta のリールカバー写真の仕様を満たす必要があります。
- 形式: JPEG。
- ファイルサイズ: 最大 8 MB。
- 色空間: sRGB。ほかの色空間の画像は変換されます。
- アスペクト比: 切り抜きや余白を避けるため、9:16 を推奨します。
- 配置: Meta が URL から直接画像を取得するため、公開サーバーに置く必要があります。
カバーはどのように切り抜かれますか?
中央を基準に切り抜かれます。画像が 9:16 でない場合、Meta は中央の 9:16 の長方形を切り出して、リールのカバーとして使います。リールをフィードに共有すると、中央の 1:1 の正方形がフィード投稿のカバーになります。顔や文字を中央付近に配置すると、どちらの切り抜きにも写ります。
thumb_offset はどのように動作しますか?
動画内の時点をミリ秒で指定し、その時点のフレームをサムネイルにします。既定値の 0 は先頭フレームです。値は 0 以上で、動画の長さより小さい必要があります。そうでない場合、リクエストは code 1、subcode 2207057 で失敗します。thumb_offset は動画コンテナにも適用されます。cover_url も指定されたリールでは、Meta は thumb_offset を無視します。
カバーは後から読み取ったり変更したりできますか?
読み取りはできます。公開済みのリールは media_type として VIDEO を返し、thumbnail_url フィールドからメディアのサムネイル画像が返されます。変更は別の話です。Meta が公開済みメディアに対して文書化している更新は、コメントの有効化と無効化だけです。そのため、カバーはコンテナの作成時に決まります。
よくある間違い
- cover_url と thumb_offset を一緒に送り、フレームが使われることを期待してしまうことです。Meta は cover_url を使い、thumb_offset を無視します。
- thumb_offset を秒で指定してしまうことです。ミリ秒で数えるため、動画の長さ以上の値はサブコード 2207057 で失敗します。
- PNG のカバーをアップロードしてしまうことです。リールのカバーは、8 MB 以下の JPEG である必要があります。
- 被写体をカバーの端に配置してしまうことです。Meta は画像の中央 9:16 と、フィードでは中央の正方形だけを残します。
このツールは cover_url も thumb_offset も受け付けないため、リールは Instagram が選んだフレームで公開されます。別のカバーは Instagram アプリで選びます。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 までです。最初の 3 日間は無料トライアルです。
よくある質問
Instagram リールのカバー画像を API でカスタム設定できますか?
はい。リールのコンテナを作成するときに、8 MB 以下の JPEG の公開 URL を cover_url として指定します。
リールのカバーは sRGB である必要がありますか?
そうすることが推奨されます。Meta の仕様では sRGB が求められており、ほかの色空間の画像は変換されます。カバーは 8 MB 以下の JPEG である必要があります。
Instagram リールでエラー 2207057 とはどういう意味ですか?
リールの thumb_offset が範囲外であることを示す code 1 のエラーです。値は 0 以上で、動画の長さより小さい必要があります。単位はミリ秒なので、5 秒地点は 5000 になります。
cover_url と thumb_offset を両方送るとどうなりますか?
Meta は cover_url の画像を使い、thumb_offset は無視します。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日