Texte alternatif sur les publications Instagram via l'API
L'API Instagram ajoute un texte alternatif à une publication d'image via le paramètre alt_text, défini à la création du conteneur de média. Il accepte jusqu'à 1 000 caractères et fonctionne sur une photo unique ou sur chaque image d'un carrousel, tandis que Reels et Stories ne le prennent pas en charge. Meta a ajouté ce champ le 24 mars 2025.
easyCoexistence publie des photos et des carrousels avec publish_instagram_post depuis Claude, ChatGPT ou votre propre code.
Le nombre maximal de caractères de texte alternatif qu'une image peut porter via l'API.
Moment où Meta a introduit le champ alt_text pour les publications d'images sur l'endpoint média.
alt_text fonctionne sur les images uniques et les images de carrousel ; Reels et Stories ne sont pas pris en charge.
Champ d'un média publié qui renvoie le texte descriptif d'une image, pour l'accessibilité.
Qu'est-ce que le texte alternatif d'une publication Instagram ?
Une description écrite d'une image, que la référence média de Meta appelle texte descriptif pour les images, destiné à l'accessibilité. Via l'API, il se définit image par image avec le paramètre alt_text à la création du conteneur, puis se relit depuis le champ alt_text une fois la publication effectuée.
Comment ajouter un texte alternatif ?
Avec alt_text sur le conteneur de l'image. POST /<IG_ID>/media avec image_url, la légende et alt_text le crée, puis POST /<IG_ID>/media_publish le publie comme d'habitude. Pour un carrousel, définissez alt_text sur le conteneur de chaque élément image, ceux créés avec is_carousel_item à true, avant de créer le conteneur du carrousel.
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>"
}Quelles publications acceptent le texte alternatif ?
Uniquement les publications d'images, comme le décrit la référence du paramètre chez Meta :
- Une publication d'image unique : prise en charge, jusqu'à 1 000 caractères.
- Les images d'un carrousel : prises en charge, chacune avec son propre texte.
- Les vidéos, y compris les éléments vidéo d'un carrousel : non prises en charge.
- Reels et Stories : non pris en charge.
- Le conteneur du carrousel lui-même : le texte va plutôt sur ses éléments image.
Comment relire le texte alternatif ?
Demandez le champ alt_text sur l'image publiée, GET /<IG_MEDIA_ID>?fields=alt_text. C'est un champ public de l'objet média, il peut donc aussi être demandé pour les images d'un carrousel via l'edge children, qui liste les photos et vidéos contenues dans la publication.
Le texte alternatif peut-il être modifié après publication ?
Meta ne documente aucun moyen de le faire. La seule mise à jour que sa référence média liste pour une publication déjà en ligne active ou désactive les commentaires ; le texte alternatif doit donc être écrit dans le conteneur avant la mise en ligne, avec la légende et l'URL de l'image.
Erreurs courantes
- Envoyer alt_text avec un Reel ou une Story. Meta ne le prend en charge que sur les publications d'images.
- Le placer sur le conteneur du carrousel. Le texte alternatif appartient à chaque élément image du carrousel.
- Dépasser 1 000 caractères. C'est le maximum que peut contenir le texte alternatif d'une image.
L'outil n'accepte pas alt_text, donc la description s'ajoute dans l'application Instagram, depuis l'option Modifier de la publication. De US$ 9 à US$ 0.75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Quelle est la longueur du texte alternatif via l'API Instagram ?
Jusqu'à 1 000 caractères par image, défini avec alt_text sur le conteneur de chaque image, donc chaque image d'un carrousel a son propre texte.
Un Reel peut-il avoir un texte alternatif via l'API ?
Non. Meta ne prend pas en charge alt_text sur les Reels ni sur les Stories.
Comment ajouter un texte alternatif à un carrousel ?
Définissez alt_text sur le conteneur de chaque élément image, créé avec is_carousel_item à true, avant de créer le conteneur du carrousel.
Quand l'API Instagram a-t-elle ajouté le texte alternatif ?
Meta a introduit le champ alt_text pour les publications d'images le 24 mars 2025.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le