通过 API 为 Instagram 帖子添加替代文本
Instagram 的 API 通过 alt_text 参数为图片帖子添加替代文本,该参数在创建媒体容器时设置。每段替代文本最多 1,000 个字符,适用于单张照片或轮播中的每张图片,Reels 和 Stories 不支持。Meta 于 2025 年 3 月 24 日新增该字段。
easyCoexistence 通过 Claude、ChatGPT 或您自己的代码,使用 publish_instagram_post 发布照片和轮播。
单张图片通过 API 最多可携带的替代文本字符数。
Meta 在媒体端点上为图片帖子引入 alt_text 字段的时间。
alt_text 适用于单张图片和轮播图片;Reels 和 Stories 不支持。
已发布媒体上的字段,返回图片的描述性文本,用于无障碍访问。
什么是 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 创建的容器。
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 个字符。这是单张图片替代文本可容纳的最大长度。
该工具不接受 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 监控
验证时间