Facebook Reels API:向 Page 发布 Reels
Facebook Reels API 分三步将 Reel 发布到 Page:通过 POST /{page-id}/video_reels 并设置 upload_phase 为 start,获得 video_id;将视频上传至 rupload.facebook.com;再通过 POST /{page-id}/video_reels 并设置 upload_phase 为 finish、video_state 为 PUBLISHED 完成发布。Meta 规定视频为 9:16 比例、时长 3 至 90 秒,每个 Page 在 24 小时内最多通过 API 发布 30 条 Reels。
easyCoexistence 通过 publish_facebook_post 将视频作为普通视频帖子发布到 Facebook Page,您可从 Claude、ChatGPT 或自有代码发起,同时支持文本、链接和照片。
在滚动 24 小时周期内,每个 Page 通过 API 发布的 Reels 数量上限,由 POST /{page_id}/video_reels 执行。
Meta 接受的 Reel 时长;作为 Page 限时动态发布的 Reel 不得超过 60 秒。
Reel 的最低分辨率;Meta 建议使用 1080 x 1920 像素,宽高比为 9 x 16。
scheduled_publish_time 可设置 Reel 的最远时间,至少提前 10 分钟,且 video_state 为 SCHEDULED。
Facebook 不支持 Reel 时长时返回的错误代码;Reels 须为 3 至 90 秒。
Reels API 如何发布 Reel?
分三步在两个主机之间完成。start 和 finish 调用发往 graph.facebook.com 上 Page 的 video_reels 边,视频本身则上传至 rupload.facebook.com,地址为 start 调用返回的 upload_url。在上传与 finish 之间,对视频的 ID 进行状态检查,可确认 Meta 是否已收到完整文件并完成处理。
Reel 需要什么样的视频?
Meta 在《Reels Publishing guide》中发布了 Reels 规格。若上传的视频在宽高比、分辨率、时长或帧率上不符合规格,将被拒绝并返回专属错误代码。用于 Page 限时动态的 Reel 还须在 60 秒以内。
如何上传视频?
向 rupload.facebook.com 上的 upload_url 发送 POST 请求,并在 Authorization: OAuth 标头中携带 Page 访问令牌。本地文件作为请求正文发送,同时将 offset 标头设为 0,file_size 设为文件大小(字节数)。已在线上的文件则改用 file_url 标头,由 Meta 自行抓取;上传成功时返回 success 为 true。
file_url支持 http 或 https 地址;需要身份验证的 URL 不受支持。- 该主机须允许 facebookexternalhit/1.1 用户代理抓取文件,若网站在 robots.txt 中屏蔽该代理,Meta 将拒绝文件。
- Meta 自有 CDN 上的文件(如 fbcdn URL)会被拒绝;Meta 建议若要在另一个 Page 复用视频,请使用交叉发布。
# <UPLOAD_URL> is the upload_url the start call returned
curl -X POST "<UPLOAD_URL>" \
-H "Authorization: OAuth <PAGE_ACCESS_TOKEN>" \
-H "file_url: https://example.com/reel.mp4"如何检查 Reel 的状态?
向 graph.facebook.com 发送 GET /{video-id}?fields=status 请求。响应包含 video_status,其值为 uploading、upload_complete、processing、ready、upload_failed、expired 或 error;另有各阶段对象:uploading_phase(含 bytes_transfered)、processing_phase(含任何错误信息)以及 publishing_phase(含 publish_status,即 draft、scheduled、published 或 error,以及 publish_time)。各阶段自身的状态为 not_started、in_progress、completed 或 error。
中断的上传如何续传?
重新发送上传 POST 请求,并将 offset 标头设为状态检查返回的 uploading_phase.bytes_transfered,即 Meta 已接收的字节数。若 Meta 不接受该 offset,将返回 OffsetInvalidError;若请求正文与文件长度不符,则返回 PartialRequestError。若重新上传仍无效,Meta 建议从第一步重新开始。
finish 调用需要哪些参数?
start 调用返回的 video_id,upload_phase 设为 finish,video_state 设为 PUBLISHED、DRAFT 或 SCHEDULED。description 承载文本,支持话题标签。title、place(适用于地点 Page)和 is_ai_generated(披露该 Reel 是否由 AI 创建或编辑)均为可选。定时 Reel 另需 scheduled_publish_time,即 UNIX 时间戳,须比当前时间晚 10 分钟以上,且不超过 29 天。Meta 返回 success 为 true。
一个 Page 通过 API 最多可发布多少条 Reels?
在滚动 24 小时周期内为 30 条。Meta 在 Reel 发布时于 POST /{page_id}/video_reels 上执行该上限,并建议应用自行执行,尤其是允许用户定时发布的应用。协作者邀请有独立上限,即每个 Page 每 24 小时 10 次;video_reels 参考文档列出了错误 613,即对此 API 的调用已超出速率限制。
需要哪些权限和 Page 任务?
需要由有权在 Page 上执行 CREATE_CONTENT 任务的人员提供 Page 访问令牌,并通过 Facebook 登录授予 pages_show_list、pages_read_engagement 和 pages_manage_posts 权限。Meta 还要求应用向用户展示其 Reels 在 Facebook 上的使用方式披露信息,并提供相应的控制选项;同时只提供公开受众,因为发布到 Page 隐含公开范围。
Reels API 会返回哪些错误?
代码 100 表示缺少必需参数,例如 upload_phase,Meta 的消息会列出所有缺失参数。另有四个错误代码用于拒绝不符合规格的视频:
- 1363040:宽高比不受支持;视频须介于 16x9 与 9x16 之间。
- 1363127:分辨率不受支持;最低为 540 x 960 像素。
- 1363128:时长不受支持;Reels 时长须为 3 至 90 秒。
- 1363129:平均帧率不受支持;Reels 须为每秒 24 至 60 帧。
如何列出 Page 的 Reels?
发送 GET /{page-id}/video_reels 请求,将返回该 Page 已发布的 Reels 及其 ID、更新时间和描述。since 和 until 可将列表限定在指定日期,日期可为 today、yesterday、UNIX 时间戳或 yyyy-mm-dd,且 until 须晚于 since。Meta 的 Feed 参考文档指出,该边用于获取发布到 Page 的 Reels。
如何通过 easyCoexistence 发布 Reel?
目前不能作为 Reel 发布。publish_facebook_post 会将视频作为普通视频帖子发送至 Page 的 videos 边,easyCoexistence 没有 video_reels 调用对应的工具;Page 访问令牌不会发放,因此也无法在您自己的代码中通过其连接执行这三步。请从 Facebook 或 Meta Business Suite 发布 Reel,或将视频作为普通视频帖子发布。
常见错误
- 将上传发送到 graph.facebook.com。视频应发送至 rupload.facebook.com,并携带 Authorization: OAuth 标头;只有 start、finish 和状态检查调用使用 graph.facebook.com。
- 将文件托管在 Meta 无法抓取的位置。若 file_url 需要登录、所在网站的 robots.txt 屏蔽了 facebookexternalhit/1.1,或位于 fbcdn 上,都会被拒绝。
- 中断上传后从头开始。应先检查状态:uploading_phase.bytes_transfered 即续传的 offset,新建会话只是最后的手段。
- 一天内为同一 Page 排队超过 30 条 Reels。Meta 按滚动 24 小时周期统计通过 API 发布的 Reels,因此定时发布的内容应分散安排。
它没有 Reels API 对应的工具,因此 Reel 需从 Facebook 或 Meta Business Suite 发布。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,并提供 3 天免费试用。
常见问题
能否通过 API 将 Reel 发布到 Facebook 个人主页或群组?
不能。Meta 的 Reels Publishing API 只将 Reels 发布到 Facebook Page,且仅交叉发布到其他 Page。
publish_facebook_post 能发布 Reels 吗?
不能。它可向 Page 发布文本、链接、照片和视频。Reel 需要 video_reels 调用,而 easyCoexistence 的工具不会发起这些调用。
如何检查 Reel 是否有版权匹配?
使用 pages_read_engagement 权限读取 GET /{video-id}?fields=copyright_check_information。Meta 在上传时进行检查,可能需要几分钟,且只有版权所有者才能看到匹配结果。
其他 Page 能否也发布我的 Reel?
可以,作为协作者。向 /{video-id}/collaborators 发送 POST 请求,并将 target_id 设为对方 Page 的 ID 即可发出邀请;对方接受后,该 Reel 也会出现在对方的 Page 上。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间