透過 API 在 Instagram 貼文加入替代文字
Instagram 的 API 透過 alt_text 參數為圖片貼文加入替代文字,該參數在建立媒體容器時設定。最多可輸入 1,000 個字元,適用於單張相片或輪播中的每張圖片,但 Reels 和限時動態不支援。Meta 於 2025 年 3 月 24 日加入此欄位。
easyCoexistence 透過 publish_instagram_post,讓你從 Claude、ChatGPT 或自己的程式碼發佈相片和輪播。
單張圖片透過 API 可承載的替代文字最多字元數。
Meta 為媒體端點的圖片貼文引入 alt_text 欄位的時間。
alt_text 適用於單張圖片及輪播圖片;Reels 和限時動態不支援。
已發佈媒體上的欄位,用於回傳圖片的描述文字,以便無障礙使用。
什麼是 Instagram 貼文的替代文字?
對圖片的文字描述。Meta 的媒體參考將其稱為圖片的描述文字,用於無障礙用途。透過 API 時,建立容器時以 alt_text 參數逐張圖片設定,貼文發佈後可從 alt_text 欄位讀取。
如何加入替代文字?
在圖片的容器上設定 alt_text。以 image_url、說明文字和 alt_text 呼叫 POST /<IG_ID>/media 建立容器,再照常呼叫 POST /<IG_ID>/media_publish 發佈。若為輪播,請在建立輪播容器之前,先為每個 is_carousel_item 設為 true 所建立的圖片項目容器設定 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 和限時動態:不支援。
- 輪播容器本身:文字改為放在其中的圖片項目上。
如何讀回替代文字?
對已發佈的圖片請求 alt_text 欄位,即 GET /<IG_MEDIA_ID>?fields=alt_text。這是媒體物件的公開欄位,因此也可透過 children 邊緣為輪播中的圖片請求,該邊緣會列出貼文內的相片和影片。
發佈後可以更改替代文字嗎?
Meta 沒有記載任何方法。其媒體參考所列出、針對已發佈貼文的唯一更新,是開啟或關閉留言,因此替代文字必須在貼文上線前,與說明文字和圖片 URL 一併寫入容器。
常見錯誤
- 為 Reel 或限時動態傳送 alt_text。Meta 只支援圖片貼文。
- 把它放在輪播容器上。替代文字應屬於輪播內的每個圖片項目。
- 輸入超過 1,000 個字元。這是單張圖片替代文字可承載的上限。
此工具不接受 alt_text,因此替代文字須在 Instagram 應用程式中,從貼文的編輯選項加入。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費試用。
常見問題
Instagram API 的替代文字最長可以多長?
每張圖片最多 1,000 個字元,使用每張圖片容器上的 alt_text 設定,因此輪播中的每張圖片各自有其文字。
可以透過 API 為 Reel 加入替代文字嗎?
不可以。Meta 不支援 Reels 或限時動態使用 alt_text。
如何為輪播加入替代文字?
在建立輪播容器之前,為每個 is_carousel_item 設為 true 所建立的圖片項目容器設定 alt_text。
Instagram 的 API 何時加入替代文字?
Meta 於 2025 年 3 月 24 日為圖片貼文引入 alt_text 欄位。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期