通过 API 发布 Instagram Reels
Instagram API 通过公开 URL 上的 MOV 或 MP4 文件发布 Reel:使用 media_type REELS 创建容器,等待 Meta 处理视频,然后发布。Reel 长度为 3 秒至 15 分钟,文件最大 300 MB。Meta 建议使用 9:16 画面,以免被裁剪或出现空白区域。
easyCoexistence 可通过 Claude、ChatGPT 或您自己的代码,使用 publish_instagram_post 发布 Reel:提供视频 URL 和 caption,视频仍在处理时,它会自行完成发布。
API 发布的最长 Reel;最短为 3 秒。
最大 Reel 文件,为 MOV 或 MP4 格式,视频为 H.264 或 HEVC,音频为 AAC。
Meta 建议检查处理中容器状态的频率,持续不超过 5 分钟。
未发布的 Reel 容器在过期前可以等待的时长。
如何发布 Reel?
分三步。第一步,POST /<IG_ID>/media,将 media_type 设为 REELS,video_url 指向文件,如需要可加上 caption;Meta 会获取视频并返回容器 ID。第二步,等待 Instagram 处理视频,并检查容器的 status_code。第三步,POST /<IG_ID>/media_publish,将 creation_id 设为容器 ID,响应中会返回新的媒体 ID。
Meta 记录了可恢复上传功能,可从电脑发送文件,但仅适用于基于 Facebook Login for Business(包括 Unified Login)构建的设置。使用 Instagram Login 时,视频始终来自公开 URL。
视频有哪些要求?
Meta 对 Reels 的规格要求,文件必须满足这些条件,Instagram 才会处理:
- 容器:MOV 或 MP4(MPEG-4 Part 14),不含编辑列表,moov atom 位于文件开头。
- 视频:H.264 或 HEVC,逐行扫描,封闭 GOP,4:2:0 色度子采样,每秒 23 至 60 帧,宽度最高 1920 像素,码率最高 25 Mbps。
- 音频:AAC,最高 48 kHz,单声道或立体声,码率 128 kbps。
- 宽高比:0.01:1 至 10:1 之间均可,建议使用 9:16。
- 时长和大小:3 秒至 15 分钟,最大 300 MB。
视频处理期间会发生什么?
容器的 status_code 在 Instagram 处理完视频之前显示为 IN_PROGRESS,处理完成后变为 FINISHED,只有此时才能发布。提前发布会失败,返回代码 9007、子代码 2207027,这表示应当等待,而不是修正。Meta 建议每分钟检查一次状态,最长不超过 5 分钟。
ERROR 表示容器未能完成处理,EXPIRED 表示容器未发布即已闲置 24 小时,两种情况都需要重新创建容器。PUBLISHED 表示该 Reel 已经上线。
API 提供哪些 Reel 选项?
除视频和 caption 外,Meta 的 Reel 容器还接受以下参数:
share_to_feed:true 时,Reel 会同时出现在 Feed 和 Reels 标签页;false 时仅保留在 Reels 标签页。两个值都不保证 Reel 会出现在 Reels 标签页中。cover_url:JPEG 文件,最大 8 MB,用作 Reels 标签页封面,按中间 9:16 的比例裁剪;分享到 Feed 时则裁剪为正方形。thumb_offset:没有封面时用作缩略图的帧,以毫秒为单位;0 表示第一帧。audio_name:Reel 音频的名称,只能设置一次。trial_params:发布试用版 Reel,在其转为正式版之前,仅与未关注该账户的用户分享。
Reel 还有哪些规则?
从创建容器那一刻起,以下规则适用于 Reel:
- Reel 不能作为轮播中的一项,始终单独发布。
- 发布时适用账户的隐私设置:开启“允许混剪”后,新 Reel 也允许混剪。
- 音乐标记仅适用于原创音频。
- 之后读取时,Reel 会报告
media_type为 VIDEO,与其他视频一样。 - 它计为账户在 24 小时内通过 API 发布的 100 条帖子中的一条。
Reel 会报告哪些指标?
通过媒体洞察端点,Reel 会报告 reach、views、likes、comments、saved、shares、total_interactions 和 reposts,以及它自有的三项指标:ig_reels_avg_watch_time、ig_reels_video_view_total_time,以及 reels_skip_rate,即前 3 秒内跳过的观看次数占比。likes、comments 和 views 仅统计自然互动,其背后的数据可能延迟最多 48 小时。
常见错误
- 在容器创建后立即发布。请等到 status_code 显示 FINISHED,否则调用会因子代码 2207027 失败。
- 发送 WebM 或 AVI 文件。Reel 必须为 MOV 或 MP4,否则 Meta 会以代码 352、子代码 2207026 拒绝。
- 以为 share_to_feed 会让 Reel 出现在 Reels 标签页。它只是添加 Feed 分享,Reels 标签页显示什么由 Instagram 决定。
- 容器创建后过夜仍未发布。它会在创建 24 小时后过期,之后发布需要一个新容器。
Reel 也可以在其自带的排期队列中定时发布。每个连接每月 US$ 9 起,连接越多单价越低,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
通过 API 发布的 Reel 最长多久?
从 3 秒到 15 分钟,MOV 或 MP4 格式,文件最大 300 MB。
能从电脑上传 Reel 吗?
使用 Instagram Login 时不可以。API 从公开 URL 获取视频,因此请先把文件放到能提供公开链接的地方。
通过 API 发布的 Reel 也会出现在 Feed 中吗?
可以。share_to_feed 参数决定 Reel 是否可以同时出现在 Feed 和 Reels 标签页中。
为什么发布 Reel 时出现 9007 错误?
Instagram 仍在处理视频。请检查容器的 status_code,等它显示为 FINISHED 后再发布;请求本身无需修改。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间