Guía: genera y edita imágenes

Crea imágenes a partir de texto, edita fotos con imágenes de referencia y usa las herramientas de fondo, ampliación y limpieza, con elección de modelos y costes.

Las imágenes son lo más rápido y barato de generar, así que son el mejor sitio para aprender la API. La mayoría de los modelos de imagen terminan en menos de un minuto, por lo que puedes usar ?wait=60 y recibir la imagen en la misma respuesta.

Texto a imagen

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "black-forest-labs/flux-2-klein-9b/text-to-image",
    "input": {
      "prompt": "Product photo of a ceramic coffee mug on a linen tablecloth, soft window light, shallow depth of field",
      "aspect_ratio": "4:3"
    }
  }'

El resultado está en data.output.assets[0].url. Si la respuesta es un 202, el modelo necesitó más de 60 segundos; lee la tarea con recordInfo.

Qué modelo usar

Quieres	Prueba	Por qué
Borradores lo más rápidos y baratos posible	`alibaba/z-image-turbo/text-to-image`	Unos diez segundos y uno o dos créditos por imagen
Buena calidad general a buen precio	`black-forest-labs/flux-2-klein-9b/text-to-image`	Rápido, nítido, sigue bien los prompts
Texto legible, carteles, diagramas	`google/nano-banana-2.1/text-to-image`, `openai/gpt-image-2/text-to-image`	Muy buenos con letras y maquetación; hasta 4K
Varias opciones en una llamada	Modelos con `num_outputs`	Una tarea, varias imágenes

Los precios cambian según el modelo y la opción. Modelos muestra el precio de partida de cada uno; su página de referencia muestra todos los tramos.

Edita con imágenes de referencia

Los modelos de edición terminan en /edit y reciben las imágenes de origen en image_urls, en el orden en que tu prompt las menciona:

{
  "model": "google/nano-banana-2.1/edit",
  "input": {
    "prompt": "Turn the scene into a bright summer afternoon and keep the composition",
    "image_urls": ["https://media.popnow.ai/movie/lighthouse.webp"]
  }
}

Di qué debe quedarse igual, no solo qué debe cambiar; los modelos de edición se toman «mantén la cara y la pose» al pie de la letra.
Con varias referencias, nómbralas por posición: «ponle la chaqueta de la segunda imagen a la persona de la primera».
Los archivos locales pasan antes por una subida; los que reutilizas van a tu biblioteca de recursos.

Herramientas de un solo paso

Las herramientas propias de PopNow reciben una sola imagen y no necesitan prompt:

ID de modelo	Qué hace
`popnow/background-remover-v1/edit`	Recorta el sujeto sobre un fondo transparente
`popnow/image-upscaler-v1/upscale`	Amplía y da nitidez a una imagen
`popnow/object-eraser-v1/edit`	Borra un objeto que señales
`popnow/image-expander-v1/edit`	Amplía la imagen más allá de sus bordes

{ "model": "popnow/background-remover-v1/edit",
  "input": { "image_url": "https://media.popnow.ai/movie/lighthouse.webp" } }

Ajustes que importan

aspect_ratio y resolution son los dos ajustes que más a menudo cambian el precio. Si dudas, pregunta a jobs/quote.
seed: si no la envías, se elige una al azar y se devuelve en el input de la tarea. Vuelve a enviar ese número para conseguir una variación cercana de un resultado que te guste; una semilla fija hace comparables las pruebas, pero no promete una imagen idéntica.
output_format: png conserva la transparencia y el detalle; jpeg pesa menos.
Los ajustes desconocidos se rechazan, así que revisa el esquema del modelo en lugar de copiar ajustes de otro.

Prompts que funcionan

Describe la imagen como si le dieras instrucciones a un fotógrafo o un ilustrador: sujeto, escenario, composición, luz, estilo. «Una taza de cerámica, vista cenital, sobre un mantel de lino, luz de ventana por la mañana, colores apagados» gana a «una foto bonita de una taza». Pon lo más importante primero y evita listas largas de palabras de estilo que tiran en direcciones opuestas.

Errores que puedes encontrar

content_rejected: el modelo rechazó el prompt o la referencia. Reformúlalo o prueba otro modelo.
invalid_asset: no se pudo leer una referencia. Comprueba que la URL devuelve la imagen en sí o sube el archivo.
unsupported_combination: este modelo no admite ahora esa combinación de ajustes; cambia el que menciona el mensaje.

Todos liberan la retención, así que una imagen fallida no cuesta nada.