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

向 Facebook 专页发布照片:单张与多张照片帖子

照片通过 POST /{page-id}/photos 发布到 Facebook 专页,url 指向网上已有的图片,或将文件以 multipart 表单数据附上,caption 为其文字。多张照片合为一条帖子:每张以 published 设为 false 上传,再把其 ID 以 media_fbid 条目放入 attached_media,发送到 POST /{page-id}/feed。

easyCoexistence 可通过 publish_facebook_post 从 Claude、ChatGPT 或您自己的代码向 Facebook 专页发布照片,可立即发布,也可定时至 90 天后,每条帖子一张照片;多张照片的帖子需在 Facebook 或 Meta Business Suite 中发布。

10 MB

照片端点可接受的最大文件大小;Meta 建议将 PNG 文件保持在 1 MB 以下,以免图像模糊。

About 24 hours

未发布照片在 Meta 服务器上的保存时长;超过该时间仍未发布的照片将被删除。

324

照片端点在图片文件缺失或无效时返回的错误代码。

temporary

定时发布帖子中照片的参数:published 必须为 false,照片本身不接受 scheduled_publish_time。

post_id

照片发布时,与照片 id 一同返回的 post_id 即携带该照片的专页帖子 ID。

如何向专页发布一张照片?

向 POST /{page-id}/photos 发送请求,url 设为网上已有的照片地址,或以 multipart/form-data 附上文件,该字段过去一直称为 source。caption 为照片的文字,支持表情符号。Meta 返回两个 ID:id 表示照片,post_id 表示携带该照片的专页帖子。

Publishing a photo from a URL
POST /{page-id}/photos
{
  "url": "https://example.com/flyer.jpg",
  "caption": "Doors open at 9 on Saturday."
}

200 OK
{
  "id": "<PHOTO_ID>",
  "post_id": "<PAGE_POST_ID>"
}

Meta 文档中有哪些照片参数?

除 url 和 caption 外,照片参考列出了以下选项,用于控制照片的发布方式:

  • published:默认为 true;设为 false 时上传照片但不发布。
  • no_story:设为 true 时,取消应用上传照片时 Meta 自动生成的动态消息。
  • alt_text_custom:图片的无障碍替代文本描述。
  • scheduled_publish_time:未发布照片帖子应上线的时间,仅适用于专页。
  • place:表示位置的专页 ID;backdated_time 用于设置更早的创建时间。
  • message:已标记为弃用,应改用 caption。

Meta 接受哪些图片文件?

JPEG、BMP、PNG、GIF 和 TIFF,每个文件最大 10 MB。Meta 建议将 PNG 文件保持在 1 MB 以下,因为较大的文件可能显示模糊。发布前,Facebook 会删除图片中的位置元数据,并将其缩放为多种尺寸用于渲染;文件缺失或无法读取时,将返回错误 324。

如何在一条帖子中发布多张照片?

分两步进行。将每张照片以 published 设为 false 上传到 POST /{page-id}/photos,此时返回其 ID,但不会发布任何内容。然后向 POST /{page-id}/feed 发送请求,附上 message 和 attached_media,每张照片对应一个 media_fbid,Meta 返回一条将照片合并展示的帖子 ID。未发布的照片会在 Meta 服务器上保存约 24 小时,因此请在此时间内完成 /feed 调用。

1UploadPOST /{page-id}/photos with url and published false, once per photo
2CollectKeep the id each upload returns
3PostPOST /{page-id}/feed with message and attached_media
4ResultOne Page post ID for the photos together

多张照片的帖子如何定时发布?

使用 Meta 自带的定时功能。上传照片时将 published 设为 false,temporary 设为 true;然后发送 feed 请求,其中 published 为 false,并附上 scheduled_publish_time 和 unpublished_content_type,值为 SCHEDULED。Meta 专页指南规定,发布时间须在请求后 10 分钟至 30 天之间,届时才会发布该帖子。

publish_facebook_post 发布照片时需要哪些参数?

account_id、image_url(一张图片的公开 HTTPS 链接)和 message(帖子文字)。每个帖子只能包含一张图片,同时传入的链接会被拒绝,因此网址应放在 message 中。若不传 scheduled_at,照片会立即发布;若传入,可设置为未来 1 分钟至 90 天内、带时区的 ISO 8601 时间,easyCoexistence 会在定时发布时复制图片并届时发布。Facebook 对照片的 10 MB 限制仍然适用,不过复制步骤可接受最大 30 MB 的图片。

如何通过 easyCoexistence 发布多张照片?

目前还不能。publish_facebook_post 只接受一个 image_url,而 easyCoexistence 没有用于 Meta 文档所述两步调用的工具:每张图片发送一次 POST 请求到 <PAGE_ID>/photos,附上 url 并将 published 设为 false,再将返回的 ID 一并发送到 <PAGE_ID>/feed。请在 Facebook 或 Meta Business Suite 中发布相册,或将照片作为单独的帖子发布。

常见错误

  • 逐张调用发布多张照片。若 published 保持为 true,每次调用 /photos 都会单独生成一条帖子;应先以未发布状态上传,再附加到同一条 feed 帖子中。
  • 等待超过一天才附加未发布的照片。Meta 只保留约 24 小时,之后即删除。
  • 定时帖子中的照片未设置 temporary。Meta 要求附于定时帖子的照片须设置 temporary 为 true,且 published 为 false。
  • 编辑了照片的 id 而非帖子。照片端点返回的 id 为照片,post_id 为帖子;文字修改应针对 post_id。
使用 EasyCoexistence 完成这些操作

每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。

常见问题

Facebook 照片帖子可以添加替代文本吗?

可以。/{page-id}/photos 上的 alt_text_custom 可设置图片的无障碍描述。publish_facebook_post 不接受该参数,因此请在照片发布后到 Facebook 上添加描述。

Facebook 会保留照片的位置数据吗?

不会。Meta 在发布前删除位置元数据;若要显示某个地点,请将 place 设为该位置所属专页的 ID。

单张照片帖子可以定时发布吗?

可以。使用 publish_facebook_post 并附上 scheduled_at,帖子会保存在 easyCoexistence 的队列中,可设置为 1 分钟至 90 天后。在 Meta 一侧,将 published 设为 false 并附上 scheduled_publish_time,同样可以定时。

easyCoexistence 为一个 Facebook 专页收费多少?

每个您连接的专页计为一个连接,每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。

继续阅读

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

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

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

验证时间