通过 Instagram API 设置 Reel 封面图
Instagram 的 API 在创建容器时有两种方式设置 Reel 封面:cover_url 指向一张用作 Reels 标签页封面的 JPEG 图片;thumb_offset 则以距视频开头的毫秒数选取视频中的一帧。两者都不传时使用第一帧;同时传入两者时,以 cover_url 为准。
Reels 封面图的最大尺寸;必须为 JPEG,其他色彩空间会转换为 sRGB。
Meta 推荐的封面比例;其他比例会裁切为中间的 9:16 矩形。
Reel 分享到 Feed 时,Meta 从封面中裁切出的中间正方形。
默认的 thumb_offset,使视频的第一帧成为缩略图。
thumb_offset 小于 0 或不小于视频时长时返回的错误子代码。
如何设置 Reel 封面?
在 Reel 的容器上设置。POST /<IG_ID>/media 配合 media_type REELS 与 video_url 时,可以传入 cover_url(Meta 会抓取并用作 Reels 标签页封面的公共图片 URL),或 thumb_offset(所用帧的位置,单位为毫秒)。封面属于容器,因此需在 Reel 发布前选定。
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 对 Reels 封面图的规格:
- 格式:JPEG。
- 文件大小:最大 8 MB。
- 色彩空间:sRGB;其他色彩空间的图片会被转换。
- 宽高比:推荐 9:16,以免被裁切或出现空白。
- 位置:公共服务器,因为 Meta 会自行从该 URL 抓取图片。
封面如何裁切?
以中间为准。图片不是 9:16 时,Meta 会裁切并以中间的 9:16 矩形作为 Reel 封面;Reel 分享到 Feed 时,中间的 1:1 正方形会成为 Feed 帖子的封面。将人脸和文字置于中心,两种裁切都能显示。
thumb_offset 如何运作?
它指定视频中的一个时刻(单位为毫秒),该时刻的帧会成为缩略图;默认值 0 即第一帧。该值必须大于等于 0 且小于视频时长,否则请求失败,返回 code 1、subcode 2207057。thumb_offset 同样适用于视频容器;如果 Reel 同时传入了 cover_url,Meta 会忽略 thumb_offset。
封面以后能读取或修改吗?
可以读取:已发布的 Reel 会返回 media_type VIDEO,其 thumbnail_url 字段会返回该媒体的缩略图。修改则是另一回事,因为 Meta 文档中记录的对已发布媒体的唯一更新,是开启或关闭评论,因此封面在创建容器时即已确定。
常见错误
- 同时发送 cover_url 和 thumb_offset,却期望得到视频帧。Meta 会使用 cover_url 并忽略 thumb_offset。
- thumb_offset 以秒为单位。它的单位是毫秒;数值达到或超过视频长度时,会以子代码 2207057 失败。
- 上传 PNG 封面。Reels 封面必须是不超过 8 MB 的 JPEG。
- 将主体放在封面边缘。Meta 保留图片中间的 9:16,在 Feed 中只保留中间的正方形。
您可以通过 Claude、ChatGPT 或自己的代码,使用 publish_instagram_post 发布 Reels。该工具不接受 cover_url 或 thumb_offset,因此 Reel 会使用 Instagram 选取的画面发布,如需其他封面,请在 Instagram 应用中选择。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75;前 3 天免费试用。
常见问题
能否为 Reel 通过 API 上传自定义封面?
可以。创建 Reel 容器时传入 cover_url,并附上不超过 8 MB 的 JPEG 公共 URL。
Reel 封面必须是 sRGB 吗?
最好是。Meta 的规格要求 sRGB,其他色彩空间的图片会被转换;封面还必须是不超过 8 MB 的 JPEG。
Instagram Reel 上的错误 2207057 是什么意思?
表示 Reel 的 thumb_offset 超出范围(属于 code 1):它必须大于等于 0 且小于视频时长,以毫秒计,因此开始后 5 秒应填 5000。
同时发送 cover_url 和 thumb_offset 会怎样?
Meta 会使用 cover_url 指定的图片,并忽略 thumb_offset。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间