Alternativtext in Instagram-Beiträgen über die API
Die Instagram-API fügt einem Bildbeitrag über den Parameter alt_text Alternativtext hinzu, der beim Erstellen des Media-Containers gesetzt wird. Er akzeptiert bis zu 1,000 Zeichen und funktioniert bei einem einzelnen Foto oder bei jedem Bild eines Karussells, während Reels und Stories ihn nicht unterstützen. Meta hat das Feld am 24. März 2025 eingeführt.
easyCoexistence veröffentlicht Fotos und Karussells mit publish_instagram_post aus Claude, ChatGPT oder Ihrem eigenen Code.
Die meisten Zeichen Alternativtext, die ein Bild über die API tragen kann.
Als Meta das Feld alt_text für Bildbeiträge am Endpoint media einführte.
alt_text funktioniert bei einzelnen Bildern und Karussellbildern; Reels und Stories werden nicht unterstützt.
Feld veröffentlichter Medien, das den beschreibenden Text eines Bildes für Barrierefreiheit zurückgibt.
Was ist Alternativtext bei einem Instagram-Beitrag?
Eine schriftliche Beschreibung eines Bildes, die Metas Medienreferenz als beschreibenden Text für Bilder zur Barrierefreiheit bezeichnet. Über die API wird sie pro Bild mit dem Parameter alt_text beim Erstellen des Containers gesetzt und nach der Veröffentlichung über das Feld alt_text ausgelesen.
Wie wird Alternativtext hinzugefügt?
Mit alt_text am Container des Bildes. POST /<IG_ID>/media mit image_url, der Bildunterschrift und alt_text erstellt ihn, und POST /<IG_ID>/media_publish veröffentlicht ihn wie gewohnt. Bei einem Karussell setzen Sie alt_text am Container jedes Bildelements, also bei den mit is_carousel_item auf true erstellten Containern, bevor Sie den Karussell-Container erstellen.
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>"
}Welche Beiträge unterstützen Alternativtext?
Nur Bildbeiträge, so wie Metas Referenz den Parameter beschreibt:
- Ein einzelner Bildbeitrag: unterstützt, bis zu 1,000 Zeichen.
- Bilder in einem Karussell: unterstützt, jedes mit eigenem Text.
- Videos, auch Videoelemente in einem Karussell: nicht unterstützt.
- Reels und Stories: nicht unterstützt.
- Der Karussell-Container selbst: Der Text gehört stattdessen zu seinen Bildelementen.
Wie liest man Alternativtext wieder aus?
Fordern Sie das Feld alt_text am veröffentlichten Bild an, GET /<IG_MEDIA_ID>?fields=alt_text. Es ist ein öffentliches Feld des Medienobjekts und kann daher auch für die Bilder eines Karussells über den Edge children abgefragt werden, der die Fotos und Videos im Beitrag auflistet.
Kann Alternativtext nach der Veröffentlichung geändert werden?
Meta dokumentiert dafür keinen Weg. Das einzige Update, das die Medienreferenz für einen veröffentlichten Beitrag auflistet, schaltet Kommentare ein oder aus. Der Alternativtext wird deshalb in den Container geschrieben, bevor der Beitrag live geht, zusammen mit Bildunterschrift und Bild-URL.
Häufige Fehler
- alt_text mit einem Reel oder einer Story senden. Meta unterstützt es nur bei Bildbeiträgen.
- Den Text auf den Karussell-Container setzen. Alternativtext gehört zu jedem Bildelement im Karussell.
- Mehr als 1,000 Zeichen schreiben. Das ist das Maximum, das der Alternativtext eines Bildes fassen kann.
Das Tool nimmt kein alt_text an, daher wird die Beschreibung in der Instagram-App hinzugefügt, über die Option Bearbeiten des Beitrags. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, die ersten 3 Tage kostenlos testen.
Häufig gestellte Fragen
Wie lang kann Alternativtext über die Instagram-API sein?
Bis zu 1,000 Zeichen pro Bild, gesetzt mit alt_text am Container jedes Bildes, sodass jedes Bild im Karussell seinen eigenen Text erhält.
Kann ein Reel über die API Alternativtext haben?
Nein. Meta unterstützt alt_text nicht bei Reels oder Stories.
Wie füge ich einem Karussell Alternativtext hinzu?
Setzen Sie alt_text am Container jedes Bildelements, erstellt mit is_carousel_item auf true, bevor Sie den Karussell-Container erstellen.
Wann hat die Instagram-API Alternativtext eingeführt?
Meta hat das Feld alt_text für Bildbeiträge am 24. März 2025 eingeführt.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am