ログイン無料トライアルを開始
easyCoexistence 公式 API

Instagram API でリールのカバー画像を設定する

Instagram API では、コンテナの作成時にリールのカバーを 2 通りの方法で設定できます。cover_url はリールタブのカバーに使う JPEG 画像の URL を指定し、thumb_offset は動画の先頭から何ミリ秒後のフレームを使うかを指定します。どちらも指定しない場合は先頭フレームが使われ、両方を送ると cover_url が優先されます。

easyCoexistence は、Claude、ChatGPT、または独自のコードから publish_instagram_post を使ってリールを公開できます。

8 MB

リールのカバー画像で最大のサイズです。JPEG である必要があり、ほかの色空間は sRGB に変換されます。

9:16

Meta が推奨するカバーの形状です。ほかの形状は中央の 9:16 の長方形に切り抜かれます。

1:1

リールをフィードに共有するときに、Meta がカバーから切り抜く中央の正方形です。

0 ms

動画の先頭フレームをサムネイルにする、thumb_offset の既定値です。

2207057

thumb_offset が 0 未満、または動画の長さ以上の場合のエラーサブコードです。

リールのカバーはどう設定しますか?

コンテナに対して設定します。POST /<IG_ID>/media で media_type に REELS を指定し、video_url を送るときに、cover_url か thumb_offset のどちらかを指定できます。cover_url は、リールタブのカバーとして Meta が取得して使う画像の公開 URL です。thumb_offset は、使用するフレームの位置をミリ秒で指定します。カバーはコンテナに属するため、リールを公開する前に選択します。

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

カバー画像はどのような条件を満たす必要がありますか?

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 と、フィードでは中央の正方形だけを残します。
EasyCoexistence で実現する

このツールは 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 監視

確認日