Reels d'essai Instagram via l'API : trial_params et promotion
L'API d'Instagram publie des reels d'essai, d'abord montrés aux seuls non-abonnés, en ajoutant trial_params à un conteneur REELS. Son graduation_strategy définit comment le reel atteint les abonnés : MANUAL laisse la décision au titulaire du compte dans l'application Instagram, et SS_PERFORMANCE le promeut automatiquement s'il obtient de bons résultats. Meta prend en charge cette fonctionnalité avec Instagram Login depuis décembre 2025.
easyCoexistence publie des Reels avec publish_instagram_post depuis Claude, ChatGPT ou votre propre code, aux abonnés comme d'habitude : l'outil n'accepte pas trial_params, donc un reel d'essai se partage depuis l'application Instagram.
Ajout des reels d'essai à l'API de publication de contenu par Meta, pour Instagram Login comme pour Facebook Login.
MANUAL, promotion à la main dans l'application Instagram, ou SS_PERFORMANCE, promotion automatique si le reel d'essai obtient de bons résultats.
Le media_type que doit avoir un conteneur dès que trial_params figure dans la requête.
Durée maximale de vidéo d'un conteneur de reel ; la plus courte est de 3 secondes et le fichier le plus lourd fait 300 Mo.
Durée pendant laquelle un conteneur de média non publié reste valide avant d'expirer.
Qu'est-ce qu'un reel d'essai ?
Un reel qu'Instagram ne montre qu'aux personnes qui ne suivent pas le compte. La promotion le transforme en reel classique, visible des abonnés, soit lorsque le titulaire du compte le décide dans l'application Instagram, soit automatiquement s'il obtient de bons résultats, selon la stratégie choisie à la publication.
Comment le publier via l'API ?
Avec les appels habituels pour un reel et un paramètre supplémentaire. Créez le conteneur avec POST /<IG_ID>/media, en définissant media_type sur REELS, le video_url, une légende et trial_params avec un graduation_strategy ; attendez que le status_code du conteneur indique FINISHED ; puis publiez-le avec POST /<IG_ID>/media_publish, en passant l'ID du conteneur comme creation_id.
POST https://graph.instagram.com/v26.0/<IG_ID>/media
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>
{
"media_type": "REELS",
"video_url": "https://www.example.com/videos/reel.mp4",
"caption": "<CAPTION>",
"trial_params": { "graduation_strategy": "MANUAL" }
}Quelle stratégie de promotion choisir ?
MANUAL lorsque quelqu'un examinera les résultats avant que les abonnés ne voient le reel : il reste auprès des non-abonnés jusqu'à ce qu'il soit promu à la main dans l'application Instagram. SS_PERFORMANCE lorsque la décision peut être laissée à Instagram : le reel d'essai est promu automatiquement s'il obtient de bons résultats. graduation_strategy est obligatoire dans trial_params, et ce sont ses deux seules valeurs.
Quelles règles restent valables ?
Toutes les règles d'un reel, puisqu'un reel d'essai se crée avec les mêmes paramètres, auxquels s'ajoute trial_params :
- Vidéo : MOV ou MP4, de 3 secondes à 15 minutes et jusqu'à 300 Mo, à une URL publique que Meta peut récupérer.
- Traitement : vérifiez le
status_codedu conteneur jusqu'à ce qu'il indique FINISHED, une fois par minute pendant 5 minutes au maximum, comme le recommande Meta. - Expiration : un conteneur non publié dans les 24 heures expire et doit être recréé.
- Légende : jusqu'à 2 200 caractères et 20 mentions @, avec 5 hashtags au plus selon la règle actuelle d'Instagram (la référence de l'API de Meta en indique encore 30).
- Carrousels : les reels ne peuvent pas y figurer.
Cela fonctionne-t-il avec Instagram Login ?
Oui. Le changelog de Meta a introduit les reels d'essai pour l'API Instagram avec Instagram Login et avec Facebook Login le 3 décembre 2025, et son guide de publication présente l'appel sur graph.instagram.com. Les autorisations concernées forment la paire dédiée à la publication : instagram_business_basic et instagram_business_content_publish.
Peut-on promouvoir un reel d'essai via l'API ?
Meta décrit deux façons de promouvoir un reel d'essai : à la main dans l'application Instagram, pour MANUAL, et automatiquement s'il obtient de bons résultats, pour SS_PERFORMANCE. Son guide de publication et sa référence des médias ne décrivent aucun appel d'API pour la promotion : le rôle de l'API prend donc fin une fois le reel d'essai publié.
Comment publier un reel d'essai depuis Claude ou ChatGPT ?
Pas via easyCoexistence aujourd'hui. publish_instagram_post crée lui-même le conteneur du Reel et n'accepte pas trial_params, donc les Reels qu'il publie vont aux abonnés comme d'habitude, et les tokens Instagram ne sont pas remis pour un appel depuis votre propre code. Partagez un reel d'essai depuis l'application Instagram, avec l'interrupteur Essai sur l'écran de partage.
Erreurs courantes
- Ajouter trial_params à un conteneur de photo, de carrousel ou de Story. Meta ne l'accepte que lorsque media_type vaut REELS.
- Omettre graduation_strategy. Il est obligatoire dans trial_params, avec la valeur MANUAL ou SS_PERFORMANCE.
- Publier avant la fin du traitement de la vidéo. media_publish ne réussit que lorsque le status_code du conteneur indique FINISHED.
- Croire que les abonnés verront un reel d'essai dès sa publication. Il ne va qu'aux non-abonnés jusqu'à sa promotion.
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
L'API Instagram peut-elle publier des reels d'essai ?
Oui. Ajoutez trial_params avec un graduation_strategy à un conteneur REELS, puis publiez-le comme d'habitude, avec Instagram Login ou Facebook Login.
trial_params peut-il être utilisé sur une photo ou un carrousel ?
Non. Meta n'accepte trial_params que sur un conteneur dont le media_type vaut REELS : les conteneurs de photo, de carrousel et de Story ne peuvent donc pas être des publications d'essai.
Les abonnés voient-ils un reel d'essai ?
Pas dans un premier temps. Un reel d'essai n'est montré qu'aux non-abonnés et ne parvient aux abonnés qu'une fois promu.
Quelle est la durée maximale d'un reel d'essai ?
La même que pour tout reel : de 3 secondes à 15 minutes, dans un fichier MOV ou MP4 de 300 Mo maximum, à une URL publique que Meta peut récupérer.
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