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

通过 API 为 Instagram 帖子添加替代文本

Instagram 的 API 通过 alt_text 参数为图片帖子添加替代文本,该参数在创建媒体容器时设置。每段替代文本最多 1,000 个字符,适用于单张照片或轮播中的每张图片,Reels 和 Stories 不支持。Meta 于 2025 年 3 月 24 日新增该字段。

easyCoexistence 通过 Claude、ChatGPT 或您自己的代码,使用 publish_instagram_post 发布照片和轮播。

1,000

单张图片通过 API 最多可携带的替代文本字符数。

24 Mar 2025

Meta 在媒体端点上为图片帖子引入 alt_text 字段的时间。

Images only

alt_text 适用于单张图片和轮播图片;Reels 和 Stories 不支持。

alt_text

已发布媒体上的字段,返回图片的描述性文本,用于无障碍访问。

什么是 Instagram 帖子中的替代文本?

对图片的文字描述。Meta 的媒体参考文档称其为用于无障碍访问的图片描述性文本。通过 API 设置时,在创建容器时用 alt_text 参数为每张图片单独设置;帖子发布后,可从 alt_text 字段读回。

如何添加替代文本?

在图片的容器上设置 alt_text。使用 image_url、说明文字和 alt_text 发送 POST /<IG_ID>/media 即可创建容器,之后照常用 POST /<IG_ID>/media_publish 发布。对于轮播,在创建轮播容器之前,为每个图片项的容器设置 alt_text,即那些 is_carousel_item 设为 true 创建的容器。

An image container with alt text
POST https://graph.instagram.com/<IG_ID>/media
Content-Type: application/json

{
  "image_url": "https://example.com/photo.jpg",
  "caption": "<CAPTION>",
  "alt_text": "<WHAT_THE_IMAGE_SHOWS>"
}

哪些帖子支持替代文本?

仅支持图片帖子,正如 Meta 参考文档对该参数的描述:

  • 单张图片帖子:支持,最多 1,000 个字符。
  • 轮播中的图片:支持,每张可有各自的文本。
  • 视频,包括轮播中的视频项:不支持。
  • Reels 和 Stories:不支持。
  • 轮播容器本身:文本应放在其图片项上。

如何读回替代文本?

请求已发布图片的 alt_text 字段:GET /<IG_MEDIA_ID>?fields=alt_text。它是媒体对象的公开字段,因此也可以通过 children 边请求轮播中的图片,该边列出帖子中的照片和视频。

发布后可以更改替代文本吗?

Meta 没有记录任何方式。其媒体参考文档列出的对已发布帖子的唯一更新操作,是开启或关闭评论,因此替代文本需要在帖子上线前写入容器,与说明文字和图片 URL 一同设置。

常见错误

  • 为 Reel 或 Stories 发送 alt_text。Meta 仅在图片帖子上支持该参数。
  • 把它放在轮播容器上。替代文本应属于轮播内每个图片项。
  • 超过 1,000 个字符。这是单张图片替代文本可容纳的最大长度。
使用 EasyCoexistence 完成这些操作

该工具不接受 alt_text,因此描述需在 Instagram 应用中,通过帖子的“编辑”选项添加。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,并提供 3 天免费试用。

常见问题

Instagram API 的替代文本最多能有多少字符?

每张图片最多 1,000 个字符,通过每张图片容器上的 alt_text 设置,因此轮播中的每张图片各自拥有自己的文本。

能通过 API 为 Reel 添加替代文本吗?

不能。Meta 不支持在 Reels 或 Stories 上使用 alt_text。

如何为轮播添加替代文本?

在创建轮播容器之前,为每个图片项的容器设置 alt_text,该容器需以 is_carousel_item 设为 true 创建。

Instagram API 是何时加入替代文本功能的?

Meta 于 2025 年 3 月 24 日为图片帖子引入了 alt_text 字段。

继续阅读

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

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

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

验证时间