Parámetro de calidad y optimización del renderizado
En esta página
Lección reescrita el 2 de noviembre de 2026. La versión anterior describía un valor
highy un parámetroqualityque no afectaban al precio, correspondientes a un modelo “pro” ya retirado. Según la documentación actual de xAI,qualityes específico de Imagine 2.0, aceptalow,mediumyauto, y cada imagen se factura según la calidad con la que se sirve.
Control de la calidad de generación

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 sirvelowen generación ymediumen 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 uso | Modelo | Calidad | Resolución |
|---|---|---|---|
| Prototipo rápido | Imagine 1.0 | — | 1k |
| Contenido web | Imagine 1.0 | — | 1k |
| Redes sociales | Imagine 2.0 | low | 1k |
| Visual de marketing | Imagine 2.0 | medium | 1k |
| Impresión, cartel | Imagine 2.0 | medium | 2k |
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
qualityes específico de Imagine 2.0 y aceptalow,mediumyauto(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,
qualityyresolutionse pasan medianteextra_body - Flujo de trabajo en 3 pasos: explora con Imagine 1.0, refina en
low, finaliza enmedium - Centraliza la selección de parámetros en una función de configuración