登录开始免费试用
easyCoexistence 官方 API

通过 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,视频仍在处理时,它会自行完成发布。

15 min

API 发布的最长 Reel;最短为 3 秒。

300 MB

最大 Reel 文件,为 MOV 或 MP4 格式,视频为 H.264 或 HEVC,音频为 AAC。

1 min

Meta 建议检查处理中容器状态的频率,持续不超过 5 分钟。

24 hours

未发布的 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 小时后过期,之后发布需要一个新容器。
使用 EasyCoexistence 完成这些操作

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 监控

验证时间