Note de l’auteur : quand l’API d’image renvoie HTTP 451 avec le code d’erreur image_safety, c’est l’image générée qui a été filtrée, pas la clé API qui a été refusée. En m’appuyant sur la documentation d’APIYI et sur de nouveaux tests, cet article explique la différence avec les erreurs 401 et 429, ce qu’il faut modifier et pourquoi il ne faut pas relancer la requête en boucle.
Quand on appelle une API d’image, on peut recevoir soudainement une réponse HTTP 451 avec error.code défini sur image_safety. Beaucoup pensent alors que leur clé API a expiré, que leur solde est insuffisant ou que l’invite contient des termes sensibles. Ils changent de clé, rechargent leur compte ou relancent la requête encore et encore, sans succès. Ce qu’il faut retenir, c’est que l’erreur 451 image_safety bloque l’image générée : le contrôle intervient après sa création. Il faut donc examiner la description de l’image, pas le compte.
Cet article ne se contente pas de parler de sécurité des contenus en général : les informations ci-dessous s’appuient sur les explications de la documentation d’APIYI concernant l’erreur 451 et sur les nouveaux tests anonymisés qui y sont publiés. Aucune donnée de test n’a été inventée pour cet article.
L’essentiel : en lisant cet article, vous pourrez distinguer une erreur 451 d’une erreur 401 ou 429 en une minute, puis modifier votre invite selon la méthode du « changement d’une seule variable » pour que la requête génère à nouveau une image.
Points clés sur l’erreur 451 image_safety lors de la génération d’images
Commençons par les conclusions essentielles. Elles découlent directement du message d’erreur et de la documentation : inutile de faire des suppositions.
| Point clé | Explication | Ce que ça vous apporte |
|---|---|---|
| C’est l’image générée qui est contrôlée | Le message indique : The generated image was filtered by the safety policy | Inutile de remettre en cause votre clé API ou votre solde |
| Le contrôle a lieu après la génération | L’API peut d’abord générer l’image, puis vérifier sa conformité. Si elle ne passe pas le contrôle, elle n’est pas renvoyée | Vous comprenez pourquoi une invite qui semble correcte peut quand même être bloquée |
| Cela ne signifie pas que l’entrée enfreint les règles | L’échec du contrôle après génération ne veut pas dire que l’invite ou l’image de référence contient explicitement des termes interdits | Pas besoin de supprimer des mots en masse ni de changer d’image de référence |
| La solution consiste à modifier l’image décrite | Préciser les éléments visuels, comme les vêtements et la composition, est plus efficace que d’ajouter des formulations négatives | Vous pouvez apporter des modifications ciblées et éviter les détours |
| Ne relancez pas la même requête à l’identique | Si la même combinaison échoue plusieurs fois, une nouvelle tentative renverra probablement encore une erreur 451 | Vous économisez du temps et des frais d’invocation |
Commencez par vérifier le code d’erreur : différence entre 451 image_safety, 401 et 429
Après une erreur, commencez par vérifier le code d’état et error.code, plutôt que de modifier votre code. Voici ce qu’indique la documentation d’APIYI sur l’erreur 451 (elle figure dans la FAQ et les actualités du centre de documentation d’apiyi.com) : la réponse a le statut HTTP 451, error.code vaut image_safety et le message est The generated image was filtered by the safety policy. Le terme clé est generated image : c’est « l’image déjà générée » qui a été filtrée par la politique de sécurité.
Cela n’a rien à voir avec l’authentification ou la limitation du débit. Une erreur 401 signifie généralement que la requête a échoué à la vérification d’identité avant même d’atteindre le modèle. Une erreur 429 indique que les requêtes sont trop fréquentes ou que le canal est occupé. Les erreurs liées au solde concernent la facturation. Ces trois cas n’ont rien à voir avec le contenu de l’image, tandis que l’erreur 451 concerne précisément ce qui a été représenté.
| Erreur | Signification courante | Étape concernée | Que faire | Peut-on réessayer à l’identique ? |
|---|---|---|---|---|
HTTP 451 image_safety |
L’image générée n’a pas passé le contrôle de sécurité côté sortie | Après la génération | Modifier la description de l’image et examiner les variables une par une | Non : si la même combinaison échoue plusieurs fois, ne la relancez pas à l’identique |
| HTTP 401 | Clé invalide ou transmise incorrectement | À l’entrée de la requête | Vérifier la clé API et les en-têtes de la requête | Non : réessayer avec une clé incorrecte ne sert à rien |
| HTTP 429 | Limitation du débit ou canal occupé | À l’entrée de la requête ou pendant la mise en file d’attente | Réessayer après un délai progressif et, si nécessaire, changer de canal | Oui, en suivant une stratégie de temporisation progressive |
| Erreur de solde | Quota insuffisant | Vérification de la facturation | Recharger le compte ou ajuster le quota | Non |
À retenir : les erreurs 451 et 401 ne doivent pas partager la même logique de nouvelle tentative. Pour une erreur 401, corrigez la configuration de la clé API ; pour une erreur 451, modifiez l’invite. Si vous traitez les deux dans une branche générique du type « en cas d’échec, réessayer 3 fois », le diagnostic ne fera que se compliquer.
Pourquoi l’erreur 451 image_safety apparaît-elle après la génération de l’image ?
La documentation appelle ce mécanisme une modération a posteriori, ou modération côté sortie. Le processus est simple : la requête passe l’authentification, le modèle génère une image à partir de l’invite et de l’image de référence, puis le système effectue un contrôle de sécurité sur l’image. Si elle ne passe pas ce contrôle, l’image n’est pas renvoyée et une erreur 451 est directement retournée.
Vous pouvez donc rencontrer un cas où « l’invite ne contient pas le moindre mot sensible », mais où la requête est tout de même bloquée. Le problème ne vient pas d’un mot isolé : c’est la combinaison de plusieurs éléments qui amène le modèle à produire une image déclenchant le filtre. Une fois cela compris, la démarche de diagnostic change : au lieu de « chercher les mots interdits », il faut « contrôler l’image finale ».
Interprétation des tests de validation du document sur 451 image_safety
La documentation d’APIYI présente une série de tests de validation anonymisés avec le modèle gpt-image-2.5-sunburst-vip. Le scénario associe une image de référence représentant une personne à une demande de création de costume, avec un gros plan du visage et des vues de face, de profil et de dos en pied, sur fond blanc. Toutes les données ci-dessous proviennent des tests de validation de la documentation ; cet article se contente de les interpréter.
| Combinaison testée dans la documentation | Résultat | Durée | Remarque |
|---|---|---|---|
| Invite d’origine + image de référence d’origine | 3/3 échecs | 81,8–95,9 secondes | Groupe de référence, erreur 451 systématique |
| Même image de référence, avec une tenue quotidienne neutre et un portrait à mi-corps | 1/1 réussite | 35,7 secondes | La requête passe après suppression des vues en pied |
| Invite d’origine, sans image de référence, avec le point de terminaison texte vers image | 1/1 réussite | 29,1 secondes | La requête passe sans les caractéristiques de la personne de l’image de référence |
| Ajout de « tenue couvrante et opaque, sans sexualisation » | 1/1 toujours en erreur 451 | 216,8 secondes | La formulation négative est inefficace |
| Description précise : personne adulte, col montant, manches longues, pantalon et chaussures de sport | 3/3 réussites | 65,1–238,6 secondes | La tenue étant décrite positivement, la requête passe de façon systématique |
Ce que les tests de validation révèlent sur le déclenchement de 451 image_safety
Dans cette série de tests, les deuxième et troisième cas sont les plus intéressants : il suffit de dissocier l’un ou l’autre des éléments — les caractéristiques de la personne dans l’image de référence ou les vues en pied — pour que l’image soit générée. La documentation en conclut que l’explication la plus plausible est que la combinaison des caractéristiques de la personne de l’image de référence et des vues en pied déclenche le filtre dans l’image générée.
La documentation précise aussi les conclusions qu’on ne peut pas tirer de ces résultats : ils ne permettent pas d’affirmer que l’image de référence enfreint les règles ni qu’un mot en particulier déclenche le filtre. C’est important. Beaucoup de développeurs voient une erreur 451 et remplacent l’image de référence ou suppriment massivement des mots, au risque d’effacer aussi des informations visuelles essentielles.
Pourquoi les formulations négatives ne résolvent pas l’erreur 451 image_safety
Dans le quatrième cas, l’ajout de « tenue couvrante et opaque, sans sexualisation » n’empêche pas l’erreur 451. Dans le cinquième, la description devient concrète et positive : personne adulte, col montant, manches longues, pantalon et chaussures de sport. Les trois essais réussissent.
La raison est simple : une formulation négative indique au modèle ce qu’il ne doit pas faire, mais pas ce qu’il doit représenter. L’image finale reste donc incertaine. En précisant le haut, le bas et les chaussures, on rend le résultat plus contrôlable et il devient naturellement plus facile de passer la vérification à la sortie.
Concernant la durée, la documentation rappelle qu’elle ne constitue qu’un indice complémentaire et ne permet pas, à elle seule, de déterminer à quel niveau intervient la vérification. Les durées des requêtes réussies et échouées se chevauchent dans les tests. Il faut donc éviter les règles de détection du type « au-delà de X secondes, la requête a été bloquée par la vérification ».
À propos de la comparaison : les données du tableau et du graphique proviennent des tests de validation de la documentation d’APIYI. Vous pouvez consulter le document d’origine dans la FAQ sur la vérification de sécurité des images générées, dans le centre de documentation d’apiyi.com, et comparer les résultats avec vos propres erreurs.
Diagnostic rapide : que faire si la génération d’images renvoie l’erreur 451 image_safety ?
Vérifiez aussi l’ID du modèle : quel modèle gpt-image appelez-vous ?
Après avoir confirmé l’erreur 451, vérifiez l’ID du modèle. Les tests de vérification de la documentation utilisent gpt-image-2.5-sunburst-vip. Pour connaître les modèles de la série gpt-image disponibles et leurs noms exacts, consultez la liste des modèles d’APIYI dans la console apiyi.com.
Vérifier l’ID du modèle permet d’écarter deux problèmes. D’abord, il faut conserver le même modèle pendant le diagnostic pour savoir quelle variable a eu un effet. Ensuite, cela évite de confondre un nom de modèle incorrect avec un problème de modération : une erreur dans le nom du modèle renvoie généralement une autre erreur, et non image_safety.
Paramètres de requête à fixer lors du diagnostic de 451 image_safety
Cet article évite les longs blocs de code et répertorie uniquement les paramètres à fixer pendant le diagnostic. L’interface est compatible avec le format OpenAI : renseignez https://api.apiyi.com/v1 dans base_url et remplacez api_key dans le SDK par votre propre clé.
| Paramètre | Exemple | Peut-il être modifié pendant le diagnostic ? |
|---|---|---|
base_url |
https://api.apiyi.com/v1 |
Non |
model |
Selon la liste des modèles d’APIYI, par exemple gpt-image-2.5-sunburst-vip, utilisé pour le nouveau test de la documentation |
Non |
| Point de terminaison | Édition d’image (avec image de référence) ou texte vers image | Non, sauf si vous testez spécifiquement l’influence de l’image de référence |
| Image de référence | L’image de référence d’origine | Non |
| Taille, quantité et autres paramètres | Conserver les valeurs d’origine | Non |
prompt |
L’invite d’origine | Ne modifier qu’une variable à la fois |
Au niveau du code, il est conseillé d’ajouter une branche dédiée à l’erreur 451 : lire le code d’état de la réponse et error.code. Si le code est 451 et que error.code vaut image_safety, consignez l’invite utilisée et arrêtez les nouvelles tentatives automatiques. Passez ensuite à une réécriture manuelle ou fondée sur des règles. Pour une erreur 401, vérifiez la clé ; pour une erreur 429, appliquez une nouvelle tentative avec temporisation exponentielle. Ne mélangez pas ces trois traitements.
Étapes de diagnostic pour 451 image_safety en ne faisant varier qu’un seul paramètre
La méthode de diagnostic décrite dans la documentation peut être organisée ainsi :
- Garder les autres conditions constantes : ne changez ni le modèle, ni le point de terminaison, ni l’image de référence, ni les paramètres. Modifiez uniquement l’invite.
- Ne modifier qu’un seul paramètre à la fois : par exemple, changez uniquement les vêtements ou le nombre de vues. Évitez de modifier trois éléments en même temps.
- Remplacer les formulations négatives par des descriptions positives : décrivez clairement le haut, le bas et les chaussures, par exemple « col montant, manches longues, pantalon et chaussures de sport ». Si nécessaire, précisez qu’il s’agit d’un « personnage adulte ».
- Effectuer 2 ou 3 nouveaux essais : une réussite isolée ne garantit pas un résultat stable. Lors des tests de la documentation, la combinaison stable a réussi 3 fois sur 3.
- Arrêter les essais si la combinaison initiale échoue à répétition : un échec 3 fois sur 3 avec le groupe de référence montre qu’il est inutile de répéter la même configuration.
- Dissocier les éléments pour déterminer la cause : testez séparément la suppression des « vues multiples en pied » et celle de l’« image de référence » afin de déterminer quelle combinaison déclenche le filtrage.
🚀 Pour commencer rapidement : si vous souhaitez d’abord reproduire et vérifier le problème dans un environnement vierge, vous pouvez obtenir un quota de test gratuit auprès d’APIYI sur apiyi.com. Utilisez la même clé API pour fixer le modèle et les paramètres, puis comparez les résultats en ne faisant varier qu’un seul paramètre. Une fois la vérification terminée, vous pourrez intégrer la solution à votre processus de production.
Exemples de reformulation des invites pour 451 image_safety
Voici quelques pistes de reformulation, selon une démarche de retest conforme à la documentation. Vous pouvez les adapter à vos besoins.
| Axe de reformulation | Formulation peu efficace | Formulation recommandée |
|---|---|---|
| Tenue | Ne pas porter de vêtements révélateurs, tenue complète | Haut à manches longues et col montant, pantalon, chaussures de sport |
| Personnage | Un mannequin | Personne adulte clairement identifiable |
| Vue | Gros plan du visage et vues intégrales de face, de profil et de dos en une seule génération | Générer d’abord un portrait en buste, ou produire les vues en plusieurs étapes |
| Style | Ne pas rendre le personnage séduisant | Vêtements décontractés et neutres, posture naturelle |
L’idée est de réduire les zones d’interprétation. Plus la description est précise, moins le modèle a de marge de manœuvre et moins le risque que l’image générée soit filtrée est élevé.
FAQ : questions fréquentes
Q1 : Que signifie `451 image_safety` ?
Cela signifie que l’image a bien été générée, mais que le résultat n’a pas passé le contrôle de sécurité. L’API ne renvoie donc pas l’image, mais une réponse HTTP 451 avec `error.code` égal à `image_safety`. Il s’agit d’un contrôle effectué après la génération, aussi appelé contrôle de sortie.
Q2 : Quelle différence entre `451 image_safety` et 401 ? Faut-il réessayer dans les deux cas ?
L’erreur 401 se produit à l’entrée de la requête et concerne la validité de la clé. L’erreur 451 survient après la génération et concerne le contenu de l’image. Elles ne doivent pas suivre la même logique de nouvelle tentative : pour une 401, corrigez la configuration de la clé ; pour une 451, modifiez la description de l’image. Réessayer sans rien changer ne résoudra aucun de ces problèmes.
Q3 : Comment distinguer `451 image_safety` de 429 ?
L’erreur 429 indique une limitation de débit ou un canal occupé. Une nouvelle tentative après un délai d’attente progressif permet généralement de résoudre le problème ; si nécessaire, vous pouvez changer de canal. L’erreur 451 signifie que le contenu a été filtré : si la même combinaison est refusée, les nouvelles tentatives échoueront aussi. Il suffit de vérifier `error.code` pour faire la différence : s’il vaut `image_safety`, traitez le problème comme étant lié au contenu.
Q4 : Si je reçois une erreur `451 image_safety`, cela signifie-t-il que mon image de référence enfreint les règles ?
On ne peut pas en tirer cette conclusion. Lors des tests de l’article, la même image de référence a permis de générer une image après avoir été remplacée par un portrait en buste, avec des vêtements neutres de tous les jours. Les résultats suggèrent plutôt que la combinaison des caractéristiques de la personne dans l’image de référence et de vues de son corps entier sous plusieurs angles a déclenché le filtre. Ils ne montrent pas que l’image de référence elle-même enfreint les règles, et ne permettent pas non plus d’identifier un mot précis comme déclencheur.
Q5 : Comment vérifier le modèle gpt-image utilisé et reproduire l’erreur 451 ?
Voici les étapes recommandées :
1. Inscrivez-vous sur APIYI, à l’adresse apiyi.com, pour obtenir une clé API et un crédit d’essai gratuit.
2. Vérifiez l’identifiant exact du modèle gpt-image dans la liste des modèles.
3. Définissez `base_url` sur `https://api.apiyi.com/v1`, fixez le modèle et les paramètres, puis procédez au diagnostic en ne modifiant qu’une variable à la fois, comme indiqué dans cet article.
Q6 : Peut-on se baser sur la durée d’une requête pour savoir si elle a été bloquée par un contrôle ?
Ce n’est pas recommandé. L’article précise que la durée peut fournir un indice, mais qu’elle ne permet pas à elle seule de déterminer à quel niveau le contrôle a eu lieu. Lors des tests, les durées des requêtes réussies et échouées se chevauchaient. Utiliser un seuil de durée pour prendre une décision risque donc d’entraîner des erreurs de classification.
Q7 : Après avoir modifié l’invite et obtenu une génération réussie, puis-je mettre en production ?
Pas encore. L’article recommande d’effectuer deux ou trois tests de régression : une seule réussite ne suffit pas à garantir la stabilité. Lors des tests, les combinaisons stables ont réussi à chaque fois, soit 3 fois sur 3. Il est recommandé d’appliquer le même critère avant la mise en production.
451 image_safety : points clés
- Ce qui est modéré : le filtre 451
image_safetyporte sur l’image générée, pas sur la clé API. - Commencez par vérifier le code d’erreur : 451, 401 et 429 correspondent respectivement à un problème de contenu, d’authentification et de limitation de débit. Le traitement diffère dans chaque cas.
- Évitez les stratégies de nouvelle tentative génériques : avec un 401, corrigez la clé API ; avec un 429, réessayez après un délai ; avec un 451, modifiez la description de l’image.
- Ne changez qu’une variable à la fois : conservez le modèle, le point de terminaison, l’image de référence et les paramètres, puis modifiez une seule partie de l’invite à chaque essai.
- Privilégiez les descriptions positives : précisez le haut, le bas et les chaussures ; c’est plus fiable que d’ajouter des phrases négatives.
- Vérifiez à nouveau : après la reformulation, effectuez deux ou trois essais. Déployez seulement lorsque le résultat est stable.
- Pour commencer : référez-vous à la liste des modèles APIYI pour les identifiants de modèle et utilisez le quota gratuit pour faire des essais comparatifs.
En résumé
Voici les points essentiels à retenir lorsque la génération d’images renvoie une erreur 451 image_safety :
- Identifiez le problème : il s’agit d’une modération côté sortie, qui bloque l’image générée. Ce n’est pas lié à la clé API, au solde ou à la limitation de débit.
- Orientez le traitement : distinguez les erreurs 451, 401 et 429 selon le code d’état et
error.code. Ne leur appliquez pas la même stratégie de nouvelle tentative. - Modifiez l’invite : gardez les autres variables constantes et remplacez les formulations négatives par des descriptions positives et précises des vêtements et de la composition. Effectuez deux ou trois essais de validation.
En cas d’erreur 451, inutile de changer immédiatement de clé API : essayez d’abord de décrire l’image de façon plus précise. Vous pouvez utiliser APIYI, sur apiyi.com, pour tester différentes formulations avec la même clé API et le même modèle, en ne changeant qu’une variable à la fois. Vous trouverez ainsi rapidement une formulation qui génère des images de façon fiable.
📚 Références
- FAQ APIYI : contrôle de sécurité des images générées : définition de
451 image_safetyet méthodes de diagnostic - Lien :
docs.apiyi.com/faq/image-output-safety-review.md -
Description : présente les formats de réponse, les contrôles après génération et des conseils de diagnostic en ne modifiant qu’une variable à la fois
-
Actualité APIYI : contrôle de sécurité des images générées (11-2026) : compte rendu de nouveaux tests
- Lien :
docs.apiyi.com/live/2026-11/image-output-safety-review.md - Description : rassemble les nouveaux tests anonymisés sur
gpt-image-2.5-sunburst-vipet précise les limites des conclusions
Auteur : équipe technique d’APIYI
Échanges techniques : contactez-nous sur la page d’accueil d’APIYI, à l’adresse apiyi.com. Pour en savoir plus sur les codes d’erreur des interfaces d’image, consultez le centre de documentation sur docs.apiyi.com.
