API で Instagram 投稿に代替テキストを設定する
Instagram API は、コンテナ作成時に設定する alt_text パラメーターで画像投稿に代替テキストを追加します。最大 1,000 文字まで指定でき、単一の写真とカルーセルの各画像に使えます。リールとストーリーズは非対応です。Meta は 2025 年 3 月 24 日にこのフィールドを追加しました。
easyCoexistence は、Claude、ChatGPT、または独自のコードから publish_instagram_post を使って写真とカルーセルを公開します。
API で 1 枚の画像に付けられる代替テキストの最大文字数。
Meta が、メディアエンドポイントの画像投稿向けに alt_text フィールドを導入した時期。
alt_text は単一画像とカルーセルの画像で使え、リールとストーリーズは非対応。
公開済みメディアのフィールドで、アクセシビリティのために画像の説明テキストを返す。
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 文字。
- カルーセル内の画像: 対応、画像ごとに個別のテキストを設定。
- 動画(カルーセル内の動画アイテムを含む): 非対応。
- リールとストーリーズ: 非対応。
- カルーセルのコンテナ自体: テキストは代わりに画像アイテムに設定します。
代替テキストはどのように読み取りますか?
公開済みの画像で alt_text フィールドをリクエストします: GET /<IG_MEDIA_ID>?fields=alt_text。メディアオブジェクトの公開フィールドなので、投稿内の写真と動画を一覧できる children エッジを通じて、カルーセルの画像に対してもリクエストできます。
公開後に代替テキストを変更できますか?
Meta はその方法を文書化していません。Meta のメディアリファレンスが公開済み投稿に対して挙げる更新は、コメントの有効化と無効化だけです。そのため、代替テキストはキャプションや画像 URL と一緒に、投稿の公開前にコンテナへ書き込みます。
よくある間違い
- リールやストーリーズに alt_text を送信すること。Meta が対応しているのは画像投稿のみです。
- カルーセルのコンテナに設定すること。代替テキストはカルーセル内の各画像アイテムに属します。
- 1,000 文字を超えて書くこと。1 枚の画像の代替テキストに入る最大量です。
このツールは alt_text を受け付けないため、説明文は Instagram アプリで、投稿の編集オプションから追加します。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
Instagram API で代替テキストは何文字まで使えますか?
画像 1 枚につき最大 1,000 文字です。各画像のコンテナに alt_text を設定するため、カルーセルの各画像にそれぞれ別のテキストを付けられます。
API でリールに代替テキストを付けられますか?
いいえ。Meta はリールとストーリーズで alt_text に対応していません。
カルーセルに代替テキストを付けるにはどうすればよいですか?
is_carousel_item を true にして作成した各画像アイテムのコンテナに alt_text を設定し、そのあとでカルーセルのコンテナを作成してください。
Instagram API が代替テキストに対応したのはいつですか?
Meta は 2025 年 3 月 24 日に、画像投稿向けの alt_text フィールドを導入しました。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日