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

通过 API 发布 Facebook 主页限时动态

Meta 的 Stories API 向 Facebook 主页发布照片和视频限时动态。照片限时动态需先将 published 设为 false 上传照片,再调用 POST /{page-id}/photo_stories 并传入其 photo_id;视频限时动态则通过 /{page-id}/video_stories 上的 start、upload 和 finish 调用完成。视频限时动态最长 60 秒,照片最大 10 MB。

easyCoexistence 可通过 publish_facebook_post 从 Claude、ChatGPT 或您自己的代码发布 Facebook 主页的帖子:文字、链接、照片和视频。

60 seconds

Meta 允许在 Facebook 主页上发布的最长视频限时动态时长。

10 MB

照片限时动态可使用的最大照片文件,格式为 JPEG、BMP、PNG、GIF 或 TIFF。

9 x 16

视频限时动态的宽高比,建议 1080 x 1920 像素,至少 540 x 960 像素。

PUBLISHED, ARCHIVED

GET /{page-id}/stories 报告的状态;仅在开启主页的限时动态存档后,才会显示已归档的限时动态。

照片限时动态如何发布?

分两步完成。先向 POST /{page-id}/photos 上传照片,并将 published 设为 false,接口会返回照片的 ID;然后发送 POST /{page-id}/photo_stories,将 photo_id 设为该 ID。Meta 返回 success 为 true 以及 post_id,即限时动态帖子的 ID。

Publishing a photo story
POST /{page-id}/photo_stories
{
  "photo_id": "<PHOTO_ID>"
}

200 OK
{
  "success": true,
  "post_id": "<STORY_POST_ID>"
}

视频限时动态如何发布?

分三步,与 Reel 的流程相同。向 POST /{page-id}/video_stories 发送 upload_phase 设为 start 的请求,会返回 video_id 以及 rupload.facebook.com 上的 upload_url。视频应上传至该地址,可以文件字节形式上传并附带 offset 和 file_size 标头,或对托管文件使用 file_url 标头。然后向 POST /{page-id}/video_stories 发送 video_id 和 upload_phase 设为 finish 的请求即可发布,并返回 post_id。

1StartPOST /{page-id}/video_stories, upload_phase start
2UploadThe bytes or a file_url, sent to the upload_url
3StatusGET /{video-id}?fields=status
4Finishupload_phase finish with video_id: returns post_id

限时动态可以使用哪些媒体?

Meta 的限时动态指南分别给出了照片和视频的规格。照片须为 .jpeg、.bmp、.png、.gif 或 .tiff 文件,大小不超过 10 MB,其中 PNG 最好保持在 1 MB 以下。视频遵循 Reels 规格,但时长上限更短:

  • 文件:建议使用 .mp4,宽高比为 9 x 16。
  • 分辨率:建议 1080 x 1920 像素,至少 540 x 960 像素。
  • 帧率:每秒 24 至 60 帧,固定帧率,逐行扫描。
  • 时长:视频限时动态最长 60 秒。
  • 编解码器:H.264 或 H.265,同时支持 VP9 和 AV1;音频采用 AAC Low Complexity,48 kHz,立体声,128 kbps 或更高。

哪些媒体不能用于限时动态?

已用于此前发布帖子的照片或视频不能使用。Meta 的规定是,为限时动态上传的媒体不能曾经用于其他帖子。托管视频还必须可以访问,因为 Meta 会拒绝来自 robots.txt 屏蔽 facebookexternalhit/1.1 用户代理的网站的文件,以及来自其自有 CDN 的文件,例如 fbcdn URL。

如何列出主页的限时动态?

GET /{page-id}/stories 会为每条限时动态返回一个对象,并可按 status 筛选,或用 since 和 until 按日期筛选。每个对象包含:

  • post_id:限时动态帖子的 ID。
  • status:PUBLISHED 或 ARCHIVED;已归档的限时动态需开启主页的限时动态存档。
  • creation_time:限时动态发布时的 UNIX 时间戳。
  • media_type 和 media_id:照片或视频,以及该媒体的 ID。
  • url:限时动态的 Facebook 地址,位于 facebook.com/stories/ 之下。

需要哪些权限?

需要来自有权对主页执行 CREATE_CONTENT 任务之人员的主页访问令牌,通过 Facebook 登录或 Facebook 商务登录获取,并授予 pages_manage_posts、pages_read_engagement 和 pages_show_list 权限。以企业系统用户身份发出的请求还需要 business_management。这三项权限与向主页信息流发布内容所需的权限相同。

限时动态何时发布?

在调用 photo_stories 或 video_stories 的 finish 调用时发布。Meta 的 Stories API 不接受发布时间:photo_stories 接收 photo_id,finish 调用接收 video_id、upload_phase 以及可选的 is_ai_generated 标志。若要定时发布,需由您自己的调度程序在该时刻发起调用。

如何通过 easyCoexistence 发布限时动态?

目前还不能。publish_facebook_post 发布的是帖子,而非限时动态,而且 easyCoexistence 没有用于 photo_stories 或 video_stories 的工具;主页访问令牌不会对外提供,因此您自己的代码也无法在其连接上发起这些调用。请在 Facebook 或 Meta Business Suite 中发布限时动态。

常见错误

  • 重复使用此前帖子中的照片。限时动态的媒体不能来自已发布的帖子,因此请将 published 设为 false 重新上传。
  • 把 90 秒的 Reel 转为限时动态。Reels 可长达 90 秒,但视频限时动态的上限为 60 秒。
  • 期望在列表中看到已归档的限时动态。只有开启主页的限时动态存档后,它们才会出现在 GET /{page-id}/stories 中。
  • 将视频发送至 graph.facebook.com。上传应发送至 upload_url,即 rupload.facebook.com 上的地址;start、finish 和状态检查调用仍保留在 graph.facebook.com。
使用 EasyCoexistence 完成这些操作

它没有用于 Stories API 的工具,因此限时动态需在 Facebook 或 Meta Business Suite 中发布。每个连接每月 US$ 9 至 US$ 0.75,连接越多单价越低,前 3 天免费。

常见问题

可以将 Reel 分享为 Facebook 主页限时动态吗?

可以,前提是时长在 60 秒或以内:Meta 的规格规定,发布到主页上的限时动态不能超过这一时长。

视频限时动态可以标注为 AI 生成吗?

可以。在 video_stories 的 finish 调用中将 is_ai_generated 设为 true 即可;默认值为 false。

如果限时动态的视频上传中断怎么办?

将 offset 设为 0 重新发送上传请求即可重新开始;若要继续上传,则将 offset 设为状态检查返回的 bytes_transfered 值。

easyCoexistence 为 Facebook 主页收费多少?

每个连接每月 US$ 9 至 US$ 0.75,前 3 天免费。每个主页为一个连接,连接越多,每个连接的单价越低。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间