Ir al contenido principal

Elegir una API de imágenes sin censura para el lanzamiento: un plan de pruebas de preparación

Plan de pruebas para una API de imágenes sin censura: entradas autorizadas, tareas asíncronas, tasa de resultados útiles, retención y entrega.

Autor
SpicyAPI Engineering
Publicado
Lectura
12 min de lectura
Actualizado
Cuatro imágenes de muestra enmarcadas junto a casillas de revisión y controles deslizantes sobre un escritorio oscuro

En resumen: filtra los endpoints por tarea y por la etiqueta de contenido que el catálogo en vivo asigna a cada uno; después prueba tus propios briefs varias veces cada uno y cuenta los resultados útiles, no las tareas terminadas. Un endpoint etiquetado como «suavizado» devuelve una tarea exitosa y facturada con una imagen atenuada, así que un estado en verde no prueba nada. Y SpicyAPI no escanea ni las solicitudes ni los resultados, de modo que las comprobaciones que mantienen tu producto dentro de la ley y de tus propias reglas te corresponden a ti. Las etiquetas y los precios de abajo son de principios de octubre de 2026; el catálogo de API de generación de imágenes sin censura en vivo es la fuente de verdad.

Qué significan las etiquetas de contenido para una integración

Cada endpoint de imagen del catálogo lleva una de cuatro etiquetas. De los 59 endpoints de imagen activos en el catálogo, 40 están etiquetados como sin censura, 3 como suavizados, 12 como filtrados y 4 no llevan etiqueta (eliminación de fondo, aumento de resolución y utilidades similares).

EtiquetaQué hace la API con un brief que va más allá de los límites del modeloQué debes gestionar tú
Sin censuraEl modelo declara que no tiene filtro de contenido y SpicyAPI reenvía la solicitud sin añadir ningún escaneo.Tus propias comprobaciones antes y después de la llamada.
SuavizadoLa tarea tiene éxito y se factura, pero la imagen vuelve atenuada.Revisa la salida; el código de estado no te lo dirá.
FiltradoEl modelo se niega. La tarea termina en failed con errorCode: "content_rejected".Muestra un mensaje neutro y no reintentes sin cambios. Un rechazo normalmente no se cobra; algunas páginas de modelo dicen que sí se cobra, así que lee la página.
Sin etiquetaNo medido.No des por hecho ninguna de las dos cosas.

La etiqueta pertenece a un endpoint, no a una familia: Wan 2.7 Pro de texto a imagen está suavizado mientras que su endpoint de edición no tiene censura, así que un benchmark que mezcle ambos compara dos promesas distintas. También es solo informativo: te dice qué esperar, no qué está garantizado.

Como no hay escaneo de plataforma, las reglas incondicionales de la política de contenido y uso pasan a ser tarea de tu producto: nada sexualizado que incluya a un menor, ninguna representación íntima de una persona real identificable sin consentimiento documentado (incluido el intercambio de caras), ninguna suplantación de identidad. Pon delante de la llamada las comprobaciones de edad, los registros de consentimiento para cualquier entrada de una persona real y una vía para que los usuarios denuncien contenido. La versión larga está en «Building on a less restrictive model» (solo disponible en inglés por ahora).

Filtra por la tarea, luego por etiqueta y precio

Escribe una frase para tu primer flujo de trabajo, por ejemplo «editar una imagen de moda con licencia, cambiando solo el fondo». Te dice qué tarea necesitas; las tareas son entradas de catálogo distintas con campos distintos. Los precios son el precio «desde» más bajo de cada página; la resolución, las referencias y las opciones cambian el importe final.

EndpointTareasEtiquetaDesdePara qué lo declara la página
Qwen Image 3.0texto a imagen, ediciónSin censura$0.03Editar de una a tres imágenes de referencia, incluido volver a escribir el texto que ya está en el encuadre
Seedream 5.0 Protexto a imagen, ediciónSin censura$0.036Componer un encuadre a partir de hasta diez imágenes de referencia, cada una con un rol nombrado
Z-Image Spicytexto a imagenSin censura$0.0124Texto a imagen en dimensiones exactas de píxeles, con la expansión de prompt apagada salvo que la actives
Prefect Pony XLtexto a imagenSin censura$0.015Imágenes fijas de anime e ilustración a partir de prompts con estilo de etiquetas
Wan 2.7 Protexto a imagen, ediciónSuavizado (texto a imagen)$0.075Una imagen de lienzo grande, 2k por defecto, hasta 4k; el filtrado varía según el endpoint
Krea 2 Mediumtexto a imagenSuavizado$0.03Una imagen a partir de un prompt largo en cinco proporciones habituales, PNG por defecto; sin seed para redirigir un fallo
Nano Banana 2texto a imagen, ediciónFiltrado$0.036Edición con hasta catorce imágenes de referencia, de 0.5K a 4K

Esta es una lista corta, no un ranking. Para un producto orientado a adultos, empieza por las filas sin censura que coincidan con tu tarea. Una fila suavizada solo funciona cuando tus briefs quedan muy dentro de sus límites; una fila filtrada encaja con la mitad apta para el trabajo de un producto mixto. Prefect Pony XL espera etiquetas separadas por comas y siete tamaños fijos, así que dale prompts con estilo de etiquetas en lugar de briefs redactados para un modelo fotorrealista.

Cada página de modelo enlaza un informe de pruebas, por ejemplo Z-Image Spicy y Seedream 5.0 Pro, con salidas reales que van desde sugerentes hasta escenas adultas intensas y un tiempo mediano (unos 18 s para Z-Image Spicy, unos 70 s para Seedream 5.0 Pro). Léelos primero y después mide la espera desde la creación de una tarea hasta un resultado descargable, medida desde tus propios servidores.

Prueba tus propios briefs, no un sustituto educado

Escribe los briefs con la intensidad que tu producto realmente va a ofrecer, con personajes adultos ficticios o con entradas que tienes permiso para usar. Un conjunto de sustitutos aptos para el trabajo puede pasar un endpoint suavizado, porque el suavizado solo aparece cuando un brief supera los límites del modelo. Guarda los briefs en un repositorio de pruebas privado, no en tickets ni en documentos públicos. Ejecuta cada fixture tres veces: lo bastante para sacar a la luz la inestabilidad y lo bastante barato para repetirlo tras un cambio.

IDFixtureQué te dice
01Tu brief más habitual, en su intensidad normalLa tasa de resultados útiles de referencia
02El mismo brief en la intensidad más alta que permitirásSi el endpoint se niega, suaviza o entrega en la parte alta de tu rango
03Tres paráfrasis inofensivas del fixture 01Si un cambio de redacción da la vuelta al resultado
04Una imagen de origen autorizada con una edición nombrada (fondo, color de ropa, iluminación)Si la edición llega a buen término y las partes protegidas sobreviven
05La misma edición con dos imágenes de referencia, cada una con un rol nombradoSi las referencias adicionales ayudan o difuminan el resultado, y qué añaden al precio
06El formato de encuadre que publicarás (por ejemplo 9:16)Si la composición se sostiene en tu tamaño real
07Un brief que tu propia aplicación debe detenerQue tu precomprobación lo bloquea y no se crea ninguna tarea
08Una solicitud cortada justo después de enviarseQue tu cliente recupera la tarea existente en lugar de pagar dos veces

Acuerda una regla de aprobación escrita antes de la ejecución: el sujeto y la composición coinciden con el brief, las regiones protegidas de una edición quedan sin cambios, la intensidad no es más suave de lo pedido y no hay defectos de anatomía o de tipografía que un cliente notaría. Registra dos números por candidato: la tasa de resultados útiles (las salidas que aprueban, divididas entre las tareas que terminaron) y el coste por resultado útil (el gasto total dividido entre ese mismo recuento), lo que hace comparable un endpoint barato pero suavizado con uno más caro pero fiable. Para una rúbrica de puntuación más completa, usa la guía de benchmark de API de imágenes.

Prueba primero un fixture en el Playground

  1. Abre la página de un endpoint de tu lista corta, por ejemplo Z-Image Spicy de texto a imagen, e inicia sesión con una cuenta con fondos. El formulario está en la página.
  2. Pega el fixture 01 en Prompt y ajusta el tamaño del encuadre (Width y Height aquí; otros endpoints usan un campo de proporción o de tamaño).
  3. Lee el precio bajo el formulario, pulsa Run y repite la ejecución dos veces más para ver la dispersión.
  4. Ejecuta los fixtures 02 y 03 del mismo modo y juzga cada resultado con tu regla de aprobación antes de escribir código.
Ilustración de fotogramas de película que pasan por un proyector y forman una imagen terminada

Fotogramas de película que pasan por un proyector y forman una imagen terminada.

Y después automatiza la misma prueba

Una vez que un fixture se comporta como se espera en el Playground, ejecútalo desde un archivo. Una cotización es gratuita: valida el cuerpo exacto que enviarías, no crea nada y no retiene fondos.

bash
spicyapi tasks quote --model alibaba/z-image-spicy/text-to-image --input-file fixture-01.json

Crea la tarea desde el mismo archivo con tasks create; los reintentos, el sondeo y los resultados están en la documentación de Tasks y la documentación de la CLI.

O deja que lo ejecute un agente. Con el servidor MCP un asistente cotiza mediante spicyapi_task_quote, y npx skills add spicyapi-ai/spicy-skill instala el Agent Skill que hace que lea el esquema en vivo antes de cada llamada.

Cinco hechos cambian la forma de construir tu arnés de pruebas:

  • Una cotización es la prueba más barata. Pasa por ella cada fixture antes de la primera ejecución pagada y vuelve a comprobar la etiqueta de cada endpoint en CI, porque las etiquetas pueden cambiar.
  • Cada endpoint solo acepta los nombres de campo propios; los campos desconocidos se rechazan. Solo el tamaño de salida se escribe de tres maneras: Z-Image toma aspect_ratio, Prefect Pony XL un único size, y Z-Image Spicy width y height. Construye un adaptador por endpoint a partir de su esquema en vivo, no una petición compartida.
  • Las imágenes de referencia pueden subir el precio. Cada una más allá de la primera añade al precio de Seedream 5.0 Pro, así que cotiza el cuerpo exacto con el número real de imágenes de referencia.
  • succeeded no significa utilizable. Solo significa que el modelo devolvió algo; revisa cada resultado con tu regla de aprobación, que es donde se detectan las imágenes suavizadas. Los rechazos normalmente no se cobran.
  • Una creación que agota el tiempo puede seguir existiendo. Vuelve a enviarla con la misma Idempotency-Key en lugar de pagar dos veces; eso es el fixture 08.

Los enlaces de descarga y los archivos generados caducan, así que copia las imágenes aprobadas a tu propio almacenamiento con la referencia de la tarea junto a ellas (artículo sobre retención de medios). Para el sondeo frente a webhooks, consulta la guía «Polling versus webhooks» (solo disponible en inglés por ahora).

Cómo tomar la decisión

Descarta los endpoints que no publiquen la tarea que necesita tu primer flujo de trabajo. Descarta los que fallan los fixtures 07 y 08. Compara el resto por tasa de resultados útiles y coste por resultado útil con los mismos briefs. Prefiere el endpoint sin censura con la mejor tasa para tu rango de intensidad; conserva un endpoint suavizado o filtrado solo donde sus límites encajen con el brief, y dilo en los textos de tu producto en lugar de prometer «cualquier cosa». Un fallback debe pasar los mismos fixtures.

Preguntas frecuentes

¿Es un endpoint sin censura automáticamente la mejor elección para mi API?

No. Significa que no hay filtro declarado, no que vaya a seguir tu brief ni que cueste menos por imagen utilizable.

¿Cómo sé que un endpoint suavizado atenuó mi imagen?

Compara el fixture 02 con el fixture 01: un endpoint suavizado conserva el sujeto pero pierde la intensidad que pediste. Nada en la respuesta de la tarea lo indica.

¿Cuesta algo un rechazo?

Normalmente no: las tareas fallidas liberan la retención completa. Algunas páginas de modelo dicen que ciertos rechazos sí se cobran, así que comprueba el coste de la tarea antes de asumir que fue gratis.

¿Puedo probar con fotos reales de clientes?

No al principio. Usa entradas autorizadas o sintéticas. Cualquier entrada de una persona real necesita consentimiento documentado para la edición y la distribución concretas, y todo lo que implique a un menor nunca está permitido.

¿Una tarea terminada significa que puedo mostrar la imagen a los usuarios?

No. Una tarea terminada solo significa que el modelo devolvió algo. Compruébala con tu regla de aprobación, que es también donde se detecta un resultado suavizado, y copia las imágenes aprobadas a tu propio almacenamiento antes de entregarlas.

¿Con qué frecuencia debería repetir las comprobaciones?

Antes del lanzamiento y después de cualquier cambio de modelo, etiqueta, precio o esquema.

También en English · 日本語 · 한국어 · Deutsch · Français · Português (Brasil) · Русский · Italiano · Polski