API de Mage · Modelo de imagen
API de Grok Image
Grok Imagine, en dos niveles
POST https://api.mage.space/v1/grok_image/generateDe un vistazo
La API de Grok Image ejecuta Grok Image 2.0 y otra variante más a través de Mage en POST https://api.mage.space/v1/grok_image/generate. Una solicitud con los ajustes por defecto cuesta 90 Gems (unos 0,09 $), sin suscripción. Grok Image admite personajes guardados y referencias mediante @handle en el prompt.
- ImagenResultado
- 2Variantes
- 90Gems por imagen, por defecto
- $0.09Aprox., en USD
Resumen
Qué hace la API de Grok Image
El modelo de imágenes Grok Imagine de xAI en dos niveles. Genera o edita a partir de hasta 3 imágenes de referencia sin perder los detalles del original. Se aplica el filtro de seguridad de xAI.
Los modelos de imágenes Grok Imagine de xAI en dos niveles, para generar y editar a partir de imágenes de referencia: Grok Image 2.0 (`grok-imagine-image-2.0`), el predeterminado, y Grok Image (`grok-imagine-image`) para borradores económicos. xAI retiró Grok Image Quality (`grok-imagine-image-quality`) el 2 de noviembre de 2026, y las solicitudes que lo indiquen se rechazan. Se aplica el filtro de seguridad de xAI.
Acepta image y additional_images como entradas.
Inicio rápido
Llama a la API de Grok Image
Define MAGE_API_KEY, envía la solicitud a /grok_image/generate y consulta status_url hasta que la solicitud termine.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_image/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "grok-imagine-image-2.0"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('grok_image', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '1:1',
model_id: 'grok-imagine-image-2.0',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("grok_image", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "grok-imagine-image-2.0",
})
print(request["result"]["url"])Modelos
Valores de model_id de Grok Image
Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.
| model_id | Nombre | Predeterminado |
|---|---|---|
| grok-imagine-image | Grok Image | |
| grok-imagine-image-2.0 | Grok Image 2.0 | Sí |
Opciones
Parámetros de Grok Image
Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.
| Campo | Valores |
|---|---|
| aspect_ratio | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20 |
| resolution | 1k, 2k |
Entradas
Entradas multimedia que acepta Grok Image
Envía cada una como una URL https, una URL de datos o un archivo subido de hasta 100 MB.
| Campo | Rol |
|---|---|
| image | La imagen de referencia. |
| additional_images | Imágenes de referencia adicionales. |
Más modelos de imagen
Otras API de generación de imágenes en Mage
API de Guava
Fotorrealismo que parece una fotografía
API de HiDream
Rápido y versátil, con prompts negativos
Krea 2 API
Una estética espectacular en segundos
API de Mango
Nuestra familia de imágenes insignia
API de MiniMax H3 Image
Imágenes nativas de 16 megapíxeles, pesos abiertos
API de MOSS-Image
Prompts largos y texto bilingüe, pesos abiertos
Preguntas frecuentes
Preguntas frecuentes
¿Cuánto cuesta la API de Grok Image?
¿Cuál es el endpoint de la API de Grok Image?
¿Qué modelos de Grok Image puedo llamar?
¿Grok Image admite imágenes de referencia o personajes?
¿Puedo usar Grok Image desde Claude o ChatGPT?
¿Cuánto tiempo se conservan los resultados de Grok Image?
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.