Relaciones de aspecto, resoluciones y formatos de salida
En esta página
Actualizado el 2 de noviembre de 2026 — Imagine.
grok-imagine-image-qualityse ha eliminado a partir del 2 de noviembre de 2026 (sus solicitudes las atiende Imagine 2.0 en calidadlow): los ejemplos ahora usangrok-imagine-image(Imagine 1.0) ygrok-imagine-image-2.0(Imagine 2.0, con calidadlow,mediumoauto). Con el SDK de OpenAI,aspect_ratio,resolutionyqualityse pasan medianteextra_body, y la edición se realiza a través del SDK de xAI o una petición HTTP.
Dominio de las dimensiones de tu imagen
La relación de aspecto y la resolución que elijas determinan directamente la apariencia y el uso de tus imágenes generadas. La API de Grok Imagine ofrece una flexibilidad considerable con numerosas relaciones predefinidas y dos niveles de resolución.
Relaciones de aspecto disponibles
Elige la relación en función del destino y hazlo antes de generar. Recortar una imagen cuadrada para convertirla en un banner panorámico después de haberla generado estropea la composición que el modelo construyó para un cuadrado: el sujeto acaba descentrado y los márgenes desaparecen. Generar directamente en el formato correcto cuesta lo mismo y te proporciona una imagen diseñada para sus proporciones.
| Relación | Orientación | Uso habitual |
|---|---|---|
| 1:1 | Cuadrada | Perfiles, iconos, Instagram |
| 16:9 | Apaisada ancha | Presentaciones, banners, vídeo |
| 9:16 | Vertical retrato | Stories, Reels, TikTok |
| 4:3 | Apaisada clásica | Fotografías tradicionales, documentos |
| 3:4 | Retrato | Pósteres, portadas de libros |
| 3:2 / 2:3 | Foto estándar | Impresiones fotográficas, postales |
| 2:1 / 1:2 | Ultra ancha / ultra vertical | Banners web, panorámicas |
| auto | Automática | El modelo elige la relación óptima |
También hay relaciones adicionales disponibles para casos concretos, como pantallas de smartphones: 9:19.5, 19.5:9, 9:20 y 20:9.
Resoluciones: 1k frente a 2k
Entre 1k y 2k, la pregunta no es «cuál es mejor», sino «dónde se va a visualizar esta imagen». En una pantalla, la diferencia es invisible para la gran mayoría de usos web, y 2k solo supone un tiempo de generación adicional. Sin embargo, se vuelve crítica para la impresión, donde el número de píxeles por centímetro determina directamente la nitidez percibida.
1k: Resolución estándar, adecuada para la mayoría de usos web. Tiempo de generación más rápido.2k: Alta resolución, ideal para impresión o visuales que requieran mucho detalle.
# Resolución estándar para web
response_web = client.images.generate(
model="grok-imagine-image",
prompt="Icono de aplicación móvil estilo neón",
extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)
# Alta resolución para impresión
response_print = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Póster de concierto art déco con tipografía elegante",
extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)
Formatos de respuesta
El parámetro response_format determina cómo se te devuelve la imagen:
URL temporal (por defecto)
response = client.images.generate(
model="grok-imagine-image",
prompt="Gato astronauta",
response_format="url"
)
# response.data[0].url → URL temporal, descarga rápidamente
JSON en Base64
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="Gato astronauta",
response_format="b64_json"
)
image_bytes = base64.b64decode(response.data[0].b64_json)
with open("astronaut_cat.png", "wb") as f:
f.write(image_bytes)
La palabra importante es temporal: la URL devuelta caduca. Una aplicación que la almacene en una base de datos y la muestre semanas después se encontrará con imágenes rotas, a menudo mucho después del despliegue. Funcionan dos opciones: descargar la imagen desde la URL inmediatamente o solicitar directamente el Base64; en cualquier caso, la imagen debe acabar en tu propio almacenamiento.
Elección de la combinación adecuada
Para cada caso de uso, estas son las combinaciones recomendadas:
- Publicación en Instagram:
1:1, resolución1k, Imagine 1.0 - Story/Reel:
9:16, resolución1k, Imagine 1.0 - Banner web:
16:9o2:1, resolución1k, Imagine 1.0 - Póster de evento:
3:4, resolución2k, Imagine 2.0 en calidadmedium - Ilustración de artículo:
16:9, resolución2k, Imagine 2.0 en calidadmedium
Puntos clave
- Más de 10 relaciones de aspecto disponibles, además del modo
auto - Dos resoluciones:
1k(rápida, web) y2k(detallada, impresión) - Dos formatos de respuesta:
url(temporal) yb64_json(persistente) - Los tipos MIME devueltos pueden ser PNG, JPEG o WebP
- Adapta la relación al canal de distribución de tu imagen