Ir al contenido principal
Español— Elegir un idioma
Menú

Parámetro de calidad y optimización del renderizado

Lección 12 de 14 Actualizado el 2 de noviembre de 2026 Principiante
En esta página
  1. Control de la calidad de generación
  2. El parámetro quality
  3. Combinación de modelo + calidad + resolución
  4. Flujo de trabajo de optimización en 3 pasos
  5. Automatizar la selección de calidad
  6. Puntos clave

Lección reescrita el 2 de noviembre de 2026. La versión anterior describía un valor high y un parámetro quality que no afectaban al precio, correspondientes a un modelo “pro” ya retirado. Según la documentación actual de xAI, quality es específico de Imagine 2.0, acepta low, medium y auto, y cada imagen se factura según la calidad con la que se sirve.

Control de la calidad de generación

El selector Velocidad / Calidad en la aplicación Grok Imagine

En la aplicación Grok, el selector Speed / Quality equilibra velocidad y fineza. En la API, este equilibrio implica dos decisiones: el modelo (Imagine 1.0 o Imagine 2.0) y, para Imagine 2.0, el parámetro quality.

El parámetro quality

quality es aceptado por grok-imagine-image-2.0, tanto para generación como para edición. Tres valores posibles:

  • low: la configuración más económica para Imagine 2.0 (0,04 $ por imagen según las tarifas listadas) y el destino al que se redirigen las solicitudes del antiguo modelo “pro”;
  • medium: mayor cómputo por imagen para obtener detalles más finos; resérvalo para imágenes donde la calidad importe más que el coste;
  • auto: el valor predeterminado cuando se omite el parámetro; actualmente sirve low en generación y medium en edición, y la imagen se factura según la calidad servida.

Para controlar tanto el renderizado como la factura, establece la calidad explícitamente en lugar de dejar que auto decida. Con el SDK de OpenAI apuntando a la API de xAI, esto se pasa mediante extra_body:

# Borrador rápido: Imagine 1.0, lo más barato
brouillon = client.images.generate(
    model="grok-imagine-image",
    prompt="Maqueta de sitio web de comercio electrónico, estilo wireframe",
)

# Visual estándar: Imagine 2.0, calidad baja
courant = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt="Ilustración de una aplicación móvil de fitness",
    extra_body={"quality": "low"},
)

# Visual final: Imagine 2.0, calidad media, resolución 2k
final = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt="Cartel publicitario de un perfume de lujo, renderizado fotorrealista",
    extra_body={"quality": "medium", "resolution": "2k"},
)

Combinación de modelo + calidad + resolución

Tres parámetros, tres efectos: el modelo establece el precio base y las funciones disponibles, quality define el nivel de detalle para Imagine 2.0 (y su tarifa), y resolution la definición de la imagen (1k por defecto, o 2k).

Caso de usoModeloCalidadResolución
Prototipo rápidoImagine 1.0—1k
Contenido webImagine 1.0—1k
Redes socialesImagine 2.0low1k
Visual de marketingImagine 2.0medium1k
Impresión, cartelImagine 2.0medium2k

Flujo de trabajo de optimización en 3 pasos

Encuentra la idea correcta donde sea barato, refínala y paga el renderizado más caro solo por la imagen seleccionada.

Paso 1: Explorar

prompts_candidats = [
    "Un barista robot haciendo café, estilo dibujos animados",
    "Un brazo robótico vertiendo café, estilo realista",
    "Una mano mecánica sosteniendo una taza humeante, estilo steampunk",
]

for prompt in prompts_candidats:
    response = client.images.generate(
        model="grok-imagine-image",
        prompt=prompt,
        n=3,
    )
    # Coste: 3 x 0,02 $ = 0,06 $ por prompt

Paso 2: Refinar

best_prompt = "Un brazo robótico vertiendo café, estilo realista"

response = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt=best_prompt,
    n=4,
    extra_body={"quality": "low", "resolution": "1k"},
)
# Coste: 4 x 0,04 $ = 0,16 $

Paso 3: Finalizar

response = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt=best_prompt + ", iluminación cinematográfica, detalles mecánicos finos",
    n=2,
    extra_body={"quality": "medium", "resolution": "2k"},
)
# Coste: 2 imágenes a la tarifa actual de "medium"

Los dos primeros pasos cuestan 0,34 $ por nueve borradores y cuatro variantes; solo las dos imágenes finales se facturan a la tarifa medium.

Automatizar la selección de calidad

Centraliza esta elección en una función para evitar que se disperse por el código. Si cambian las tarifas o se añade un modelo, solo habrá que modificar un lugar.

CONFIGS = {
    "prototype": {"model": "grok-imagine-image", "extra_body": {"resolution": "1k"}},
    "web": {"model": "grok-imagine-image", "extra_body": {"resolution": "1k"}},
    "social": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "low", "resolution": "1k"}},
    "marketing": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "medium", "resolution": "1k"}},
    "print": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "medium", "resolution": "2k"}},
}

def generate_smart(prompt, usage="web"):
    """Genera una imagen con parámetros adecuados al caso de uso."""
    config = CONFIGS.get(usage, CONFIGS["web"])
    return client.images.generate(prompt=prompt, **config)

Fuentes oficiales: Image Generation — Quality · grok-imagine-image-quality Retirement on November 2, 2026 · Pricing

Puntos clave

  • quality es específico de Imagine 2.0 y acepta low, medium y auto (valor predeterminado)
  • La imagen se factura según la calidad servida: establece la calidad explícitamente para controlar la factura
  • Con el SDK de OpenAI, quality y resolution se pasan mediante extra_body
  • Flujo de trabajo en 3 pasos: explora con Imagine 1.0, refina en low, finaliza en medium
  • Centraliza la selección de parámetros en una función de configuración