Nota del autor: cuando la API de imágenes devuelve HTTP 451 con el código de error image_safety, lo que se ha filtrado es la imagen generada, no una clave API rechazada. Este artículo explica, según la documentación de APIYI y las pruebas de verificación, en qué se diferencia de los errores 401 y 429, qué conviene cambiar y qué tipo de reintentos hay que evitar.
Al llamar a una API de imágenes, de pronto recibes HTTP 451 y error.code es image_safety. La primera reacción de mucha gente es pensar que la clave API ha caducado, que no hay saldo suficiente o que la indicación contiene palabras sensibles. Cambian la clave, recargan saldo o vuelven a intentarlo una y otra vez, pero el resultado es el mismo: error. Lo importante es que 451 image_safety filtra la imagen generada; la revisión se realiza después de generar la imagen. Por eso, la investigación debe centrarse en la descripción visual, no en la cuenta.
Este no es un artículo genérico de divulgación sobre seguridad de contenido. Lo que sigue se basa en la explicación de HTTP 451 de la documentación de APIYI y en las pruebas de verificación anonimizadas que ya se han publicado; no hemos inventado datos de prueba.
Valor principal: al terminar de leer, podrás distinguir en un minuto los errores 451, 401 y 429, y hacer que la solicitud genere una imagen de nuevo con el método de modificar una sola variable de la indicación.
Puntos clave sobre el error 451 image_safety al generar imágenes
Empecemos por las conclusiones más importantes. Todas se basan en el propio mensaje de error y en la documentación; no hace falta hacer suposiciones.
| Punto clave | Explicación | Qué significa para ti |
|---|---|---|
| Se revisa la imagen de salida | El mensaje dice: The generated image was filtered by the safety policy |
No hace falta que sigas dudando de la clave API o del saldo |
| La revisión se hace después de generar la imagen | Es posible que la API genere primero la imagen y luego la revise; si no supera el control, no la devuelve | Así se entiende por qué también pueden bloquear una indicación que «parece estar bien» |
| No significa que la entrada infrinja las normas | Que la revisión posterior falle no quiere decir que la indicación o la imagen de referencia contengan términos claramente prohibidos | No hace falta eliminar muchas palabras ni cambiar la imagen de referencia |
| La solución es modificar la imagen descrita | Es más eficaz especificar claramente elementos visuales como la ropa y la composición que añadir más frases negativas | Podrás hacer cambios concretos y evitar pruebas innecesarias |
| No vuelvas a intentarlo sin cambios | Si la misma combinación falla varias veces, es muy probable que vuelva a dar un error 451 | Ahorrarás tiempo y costes de invocación |
Primero, identifica el código de error: diferencias entre 451 image_safety, 401 y 429
Cuando recibas un error, lo primero es revisar el código de estado y error.code, no cambiar el código de inmediato. Esto es lo que indica la documentación de APIYI sobre el error 451 —incluido en las preguntas frecuentes y las novedades del centro de documentación de apiyi.com—: la respuesta es HTTP 451, error.code es image_safety y el mensaje es The generated image was filtered by the safety policy. La expresión clave es generated image: significa que la política de seguridad ha filtrado «la imagen que ya se había generado».
Esto es muy distinto de los problemas de autenticación o de limitación de solicitudes. Por lo general, un error 401 indica que la solicitud no superó la autenticación antes de llegar al modelo; un 429 señala que se han enviado demasiadas solicitudes o que el canal está ocupado; y los errores de saldo están relacionados con la facturación. Ninguno de estos tres casos tiene que ver con «lo que se dibujó». En cambio, el error 451 sí depende de «lo que se dibujó».
| Error | Significado habitual | Fase en la que ocurre | Qué hacer | ¿Conviene reintentar sin cambios? |
|---|---|---|---|---|
HTTP 451 image_safety |
La imagen generada no superó la revisión de seguridad de salida | Después de generar la imagen | Modificar la descripción visual y probar cambiando una variable a la vez | No; si la misma combinación falla varias veces, no la vuelvas a enviar sin cambios |
| HTTP 401 | La clave no es válida o no se ha enviado correctamente | Entrada de la solicitud | Revisar la clave y los encabezados de la solicitud | No; reintentar con una clave incorrecta no sirve |
| HTTP 429 | Límite de solicitudes o canal ocupado | Entrada de la solicitud o fase de espera | Reintentar tras una pausa progresiva y, si es necesario, cambiar de canal | Sí, siguiendo una estrategia de espera progresiva |
| Error de saldo | Crédito insuficiente | Comprobación de facturación | Añadir saldo o ajustar el límite | No |
Un detalle importante: no uses la misma lógica de reintento para los errores 451 y 401. Para el 401, debes corregir la configuración de la clave; para el 451, modificar la indicación. Si incluyes ambos en una rama genérica de «si falla, reintentar 3 veces», solo complicarás el diagnóstico.
Por qué 451 image_safety aparece después de generar la imagen
La documentación llama a este mecanismo moderación posterior o moderación del lado de la salida. El flujo es sencillo: la solicitud supera la autenticación, el modelo genera una imagen a partir de la indicación y la imagen de referencia, y después el sistema realiza una comprobación de seguridad. Si no la supera, no devuelve la imagen y responde directamente con un error 451.
Por eso puede ocurrir que te bloqueen aunque la indicación no contenga ninguna palabra sensible. El motivo no es una palabra concreta, sino que la imagen que genera el modelo al combinar varios elementos activa el filtro. Cuando entiendes esto, el enfoque para investigar el problema cambia: en lugar de buscar palabras prohibidas, se trata de controlar la imagen final.
Interpretación de una nueva prueba de documentación sobre 451 image_safety
La documentación de APIYI presenta una nueva prueba anonimizada con el modelo gpt-image-2.5-sunburst-vip. El escenario combina una imagen de referencia de una persona con requisitos de diseño de vestuario e incluye un primer plano del rostro y vistas de cuerpo completo de frente, de lado y de espaldas, sobre un fondo blanco. Todos los datos siguientes proceden de la nueva prueba documentada; aquí solo los analizamos.
| Combinación probada en la documentación | Resultado | Tiempo | Observaciones |
|---|---|---|---|
| Indicación original + imagen de referencia original | 3/3 fallidas | 81.8–95.9 segundos | Grupo de referencia: 451 de forma consistente |
| La misma imagen de referencia, con ropa neutra de diario y retrato de medio cuerpo | 1/1 correcta | 35.7 segundos | Se elimina la vista de cuerpo completo y la solicitud pasa |
| Indicación original, sin imagen de referencia y con el endpoint de texto a imagen | 1/1 correcta | 29.1 segundos | La solicitud pasa al no incluir los rasgos de la persona de la imagen de referencia |
| Solo se añade «ropa completa y opaca, sin sexualizar» | 1/1 sigue dando 451 | 216.8 segundos | La formulación negativa no funciona |
| Se especifican claramente una persona adulta, cuello alto, mangas largas, pantalones largos y zapatillas deportivas | 3/3 correctas | 65.1–238.6 segundos | Al describir la ropa de forma positiva y concreta, las solicitudes pasan de manera consistente |
Qué revela la nueva prueba sobre cómo se activa 451 image_safety
Lo más destacable de esta prueba son los grupos segundo y tercero: basta con separar cualquiera de estos elementos —los rasgos de la persona de la imagen de referencia o las vistas de cuerpo completo— para que la solicitud genere una imagen. A partir de esto, la documentación considera más probable que el filtro se active cuando los rasgos de la persona de referencia se combinan con varias vistas de cuerpo completo.
La documentación también deja claro qué conclusiones no se pueden sacar: no se puede afirmar que la imagen de referencia infrinja las normas ni que una palabra concreta sea el desencadenante. Esto es importante. Muchos desarrolladores ven un error 451 y cambian la imagen de referencia o eliminan muchas palabras, con lo que terminan quitando también información necesaria sobre la imagen que quieren generar.
Por qué las formulaciones negativas no resuelven 451 image_safety
En el cuarto grupo solo se añadió «ropa completa y opaca, sin sexualizar», pero la solicitud siguió dando 451. En el quinto, la descripción se cambió por indicaciones positivas y concretas: una persona adulta, cuello alto, mangas largas, pantalones largos y zapatillas deportivas. Las tres solicitudes se completaron correctamente.
La razón es sencilla. Una formulación negativa solo le dice al modelo qué no debe hacer, pero no qué debe representar; por eso, la imagen final sigue siendo incierta. Al especificar la parte superior, la parte inferior y el calzado, el resultado es más controlable y es más probable que pase la revisión de la imagen generada.
En cuanto al tiempo, la documentación advierte expresamente que solo sirve como referencia complementaria y que no permite determinar por sí solo en qué capa se produce la revisión. En la nueva prueba, los tiempos de las solicitudes correctas y fallidas se solapan. Por eso, conviene evitar reglas como «si tarda más de X segundos, significa que la revisión la ha bloqueado».
Nota sobre la comparación: Los datos de la tabla y de la imagen comparativa proceden de la nueva prueba de la documentación de APIYI. Puedes consultar el original en la sección de preguntas frecuentes sobre la revisión de seguridad de la generación de imágenes del centro de documentación de apiyi.com y compararlo con tus propios errores.
Guía rápida para diagnosticar el error 451 image_safety al generar imágenes
Verifica de nuevo el ID del modelo: confirma qué modelo gpt-image estás usando
Después de confirmar que se trata del error 451, el segundo paso es comprobar el ID del modelo. En las pruebas de la documentación se usa gpt-image-2.5-sunburst-vip. Para consultar los modelos disponibles de la serie gpt-image y sus nombres exactos, revisa la lista de modelos de APIYI en el panel de control de apiyi.com.
Comprobar el ID del modelo tiene dos objetivos. Primero, durante el diagnóstico debes mantener el mismo modelo; de lo contrario, no podrás determinar qué variable ha influido en el resultado. Segundo, evitarás confundir un nombre de modelo incorrecto con un problema de moderación: un nombre erróneo suele devolver otro tipo de error, no image_safety.
Parámetros de solicitud para diagnosticar 451 image_safety
Aquí no incluimos bloques largos de código; solo enumeramos los parámetros que conviene mantener fijos durante el diagnóstico. La interfaz es compatible con el formato de OpenAI. Introduce https://api.apiyi.com/v1 en base_url y sustituye el valor de api_key en el SDK por tu propia clave.
| Parámetro | Valor de ejemplo | ¿Se puede modificar durante el diagnóstico? |
|---|---|---|
base_url |
https://api.apiyi.com/v1 |
No |
model |
Usa como referencia la lista de modelos de APIYI; por ejemplo, gpt-image-2.5-sunburst-vip, empleado en las pruebas de la documentación |
No |
| Endpoint | Edición de imágenes (con imagen de referencia) o texto a imagen | No, salvo que estés probando específicamente el efecto de la imagen de referencia |
| Imagen de referencia | La imagen de referencia original | No |
| Tamaño, cantidad y otros parámetros | Mantén los valores originales | No |
prompt |
La indicación original | Cambia una sola variable cada vez |
En el código, recomendamos añadir una rama independiente para el error 451: leer el código de estado de la respuesta y error.code; si es 451 y el código es image_safety, registrar la indicación usada y detener los reintentos automáticos para pasar a un proceso de reescritura manual o basado en reglas. El error 401 debe ir por la ruta de comprobación de la clave y el 429, por la de reintentos con espera progresiva. No mezcles estas tres rutas.
Pasos para diagnosticar 451 image_safety modificando una sola variable
El método de diagnóstico descrito en la documentación se puede resumir así:
- Mantén fijas las demás condiciones: no cambies el modelo, el endpoint, la imagen de referencia ni los parámetros; modifica solo la indicación.
- Cambia una sola variable cada vez: por ejemplo, modifica solo la ropa o solo la cantidad de vistas. No cambies tres cosas a la vez.
- Sustituye las frases negativas por descripciones afirmativas: especifica claramente la parte superior, la parte inferior y el calzado; por ejemplo, «cuello alto y mangas largas, pantalones largos y zapatillas deportivas». Si hace falta, indica explícitamente que se trata de una «persona adulta».
- Repite la prueba de 2 a 3 veces: que funcione una vez no significa que el resultado sea estable. En las pruebas de la documentación, la combinación estable tuvo 3 éxitos de 3 intentos.
- Deja de reintentar si la combinación original falla repetidamente: si el grupo de referencia falla en 3 de 3 intentos, no tiene sentido volver a intentarlo sin cambios.
- Aísla los factores solo si necesitas localizar la causa: prueba por separado a «quitar las múltiples vistas de cuerpo entero» y a «quitar la imagen de referencia» para determinar qué combinación activa el filtro.
🚀 Inicio rápido: Si primero quieres reproducir y validar el problema en un entorno limpio, te recomendamos obtener una cuota de prueba gratuita en APIYI, apiyi.com. Usa la misma clave y mantén fijos el modelo y los parámetros para comparar cambios de una sola variable. Cuando termines la validación, intégralo en el flujo de producción.
Ejemplo de reescritura de indicaciones para 451 image_safety
A continuación se proponen varias formas de reescribir las indicaciones siguiendo un enfoque de nuevas pruebas según la documentación. Puedes adaptar la redacción a las necesidades de tu caso de uso.
| Enfoque | Redacción poco eficaz | Redacción recomendada |
|---|---|---|
| Vestimenta | No revelar demasiado, ropa completa | Camiseta de manga larga y cuello alto, pantalones largos y zapatillas deportivas |
| Persona | Una modelo | Persona adulta claramente identificable como tal |
| Vistas | Primer plano del rostro y vistas de cuerpo entero de frente, de lado y de espaldas en una sola generación | Generar primero un retrato de medio cuerpo o crear las vistas en varios pasos |
| Estilo | Sin sexualizar | Ropa informal y neutra, postura natural |
La clave de la reescritura es reducir la ambigüedad. Cuanto más concreta sea la descripción, menos margen tendrá el modelo para improvisar y menor será la probabilidad de que se filtre la imagen generada.
Preguntas frecuentes (FAQ)
P1: ¿Qué significa 451 image_safety?
Significa que la imagen se generó, pero no superó la revisión de seguridad. Por eso, la interfaz no devuelve la imagen y responde con el código HTTP 451 y `error.code` con el valor `image_safety`. Se trata de una revisión posterior a la generación, también llamada revisión de salida.
P2: ¿Qué diferencia hay entre 451 image_safety y 401? ¿Hay que reintentar en ambos casos?
El error 401 se produce al recibir la solicitud y está relacionado con la validez de la clave. El 451 aparece después de generar la imagen y está relacionado con su contenido. No conviene aplicar la misma lógica de reintentos a ambos casos: para el 401 hay que corregir la configuración de la clave; para el 451, modificar la descripción de la imagen. Reintentar sin cambios no resolverá ninguno de los dos errores.
P3: ¿Cómo distingo 451 image_safety de 429?
El error 429 indica que hay un límite de solicitudes o que el canal está ocupado. Normalmente, se puede resolver esperando un poco y reintentando; si es necesario, también se puede cambiar de canal. El 451 indica que se ha filtrado el contenido: si se repite la misma combinación, los reintentos seguirán fallando. Basta con revisar `error.code`: si es `image_safety`, hay que tratarlo como un problema de contenido.
P4: Si recibo un 451 image_safety, ¿significa que mi imagen de referencia infringe las normas?
No se puede concluir eso. En las pruebas documentadas, se pudo generar la imagen al usar la misma imagen de referencia y cambiar la descripción a un retrato de medio cuerpo con ropa cotidiana y neutra. La conclusión del documento es que hay más indicios de que la combinación de los rasgos de la persona de la imagen de referencia con una vista de cuerpo completo desde varios ángulos activó el filtro, y no de que la imagen de referencia infrinja las normas por sí sola. Tampoco se puede afirmar que una palabra concreta haya activado el filtro.
P5: ¿Cómo confirmo qué modelo gpt-image estoy usando y reproduzco el error 451?
Se recomienda seguir estos pasos:
1. Regístrate en APIYI, en apiyi.com, y obtén una clave API y créditos gratuitos de prueba.
2. Comprueba el ID exacto del modelo de la serie gpt-image en la lista de modelos.
3. Configura `base_url` como `https://api.apiyi.com/v1`, fija el modelo y los parámetros, y sigue los pasos de este artículo para investigar cambiando una sola variable cada vez.
P6: ¿Puedo saber si una solicitud ha sido bloqueada por la revisión según el tiempo que tarda?
No es recomendable. El documento indica claramente que el tiempo de respuesta solo sirve como dato complementario y no basta para determinar por sí solo en qué nivel se realizó la revisión. En las pruebas, los tiempos de las solicitudes exitosas y fallidas se solaparon. Usar un umbral de tiempo para tomar decisiones puede llevar a conclusiones erróneas.
P7: Si la indicación modificada funcionó una vez, ¿ya puedo ponerla en producción?
Todavía no. El documento recomienda repetir la prueba entre 2 y 3 veces: que funcione una sola vez no garantiza que el resultado sea estable. En las pruebas, las combinaciones estables tuvieron éxito en 3 de 3 intentos. Se recomienda comprobarlo con el mismo criterio antes de ponerlas en producción.
451 image_safety: puntos clave
- Qué se revisa: el filtro
image_safetydel error 451 analiza la imagen generada, no la clave. - Primero, revisa el código de error: 451, 401 y 429 corresponden a contenido, autenticación y limitación de solicitudes, respectivamente. Cada uno requiere un tratamiento distinto.
- No uses la misma estrategia de reintento: con un 401, corrige la clave; ante un 429, reintenta con espera progresiva; con un 451, modifica la descripción de la imagen.
- Investiga cambiando una sola variable: fija el modelo, el endpoint, la imagen de referencia y los parámetros. Cambia solo una parte de la indicación cada vez.
- Las descripciones positivas son más eficaces: especificar la parte superior, la parte inferior y el calzado es más fiable que añadir frases negativas.
- Haz pruebas de regresión: repite la prueba de 2 a 3 veces después de reescribir la indicación y ponla en producción cuando supere las pruebas de forma estable.
- Cómo empezar: consulta la lista de modelos de APIYI para confirmar el ID del modelo y usa la cuota gratuita para hacer pruebas comparativas.
Resumen
Puntos clave si la generación de imágenes devuelve un error 451 image_safety:
- Identifica el problema: se trata de una revisión del contenido generado. El filtro bloquea la imagen, y no tiene que ver con la clave, el saldo ni la limitación de solicitudes.
- Separa los casos: distingue el error 451 de los errores 401 y 429 según el código de estado y
error.code. No uses la misma estrategia de reintento para todos. - Cambia la indicación: mantén fijas las demás variables y sustituye las frases negativas por descripciones positivas y concretas de la ropa y la composición. Después, repite la prueba de 2 a 3 veces.
Si recibes un error 451, no te apresures a cambiar la clave. Prueba primero con una descripción de la imagen más concreta. Te recomendamos usar APIYI apiyi.com con la misma clave y el mismo modelo, y cambiar una sola variable cada vez para encontrar rápidamente una forma de describir la imagen que genere resultados de manera estable.
📚 Recursos de referencia
- Preguntas frecuentes de APIYI: revisión de seguridad de la salida de imágenes: definición de
image_safety451 y métodos de diagnóstico - Enlace:
docs.apiyi.com/faq/image-output-safety-review.md -
Descripción: incluye formatos de respuesta, información sobre la revisión posterior y recomendaciones para diagnosticar el problema modificando una sola variable cada vez
-
Actualización de APIYI: revisión de seguridad de la salida de imágenes (2026-11): registro de las nuevas pruebas de la documentación
- Enlace:
docs.apiyi.com/live/2026-11/image-output-safety-review.md - Descripción: recoge las nuevas pruebas anonimizadas con
gpt-image-2.5-sunburst-vipy los límites de las conclusiones
Autor: Equipo técnico de APIYI
Contacto técnico: Puedes ponerte en contacto con nosotros en la página de inicio de APIYI, apiyi.com. Para consultar más códigos de error de las interfaces de imágenes, visita el centro de documentación en docs.apiyi.com.
