De un vistazo
La API de Grok Image ejecuta Grok Image Quality y otras 2 variantes a través de Mage en POST https://api.mage.space/v1/grok_image/generate. Una solicitud con los ajustes predeterminados cuesta 75 Gems (unos $0.075), sin suscripción. Grok Image admite personajes y referencias guardados mediante @handle en el prompt.
Imagen
Resultado
3
Variantes
75
Gems por imagen, por defecto
$0.075
Aprox., en USD
Resumen
Qué hace la API de Grok Image
El modelo de imágenes Grok Imagine de xAI en tres niveles de calidad. 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 tres niveles de calidad, para generar y editar a partir de imágenes de referencia. 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-quality"
}' | 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-quality',
});
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-quality",
})
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-quality | Grok Image Quality | Sí |
| grok-imagine-image-2.0 | Grok Image 2.0 |
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
Imagen · desde 37 Gems
API de Guava
Fotorrealismo que parece una fotografía
Imagen · desde 20 Gems
API de HiDream
Rápido y versátil, con prompts negativos
Imagen · desde 20 Gems
Krea 2 API
Una estética espectacular en segundos
Imagen · desde 135 Gems
API de Mango
Nuestra familia de imágenes insignia
Imagen · desde 68 Gems
API de Nano Banana 2
Texto nítido y legible, hasta 4K
Imagen · desde 15 Gems
API de SDXL Plus
SDXL con rostros y manos corregidos
Preguntas frecuentes
Preguntas frecuentes
¿Cuánto cuesta la API de Grok Image?
Una solicitud de Grok Image con los ajustes predeterminados (Grok Image Quality) cuesta 75 Gems, unos $0.075. Otras resoluciones, duraciones y variantes cambian el precio; la respuesta indica el cargo exacto. Si una generación falla, se reembolsa; si la bloquea la política de contenido de Mage, no.
¿Cuál es el endpoint de la API de Grok Image?
POST https://api.mage.space/v1/grok_image/generate con un encabezado Authorization: Bearer que lleve tu clave de API de Mage. La respuesta incluye un status_url que debes consultar para obtener el resultado.
¿Qué modelos de Grok Image puedo llamar?
grok-imagine-image (Grok Image), grok-imagine-image-quality (Grok Image Quality), grok-imagine-image-2.0 (Grok Image 2.0). El predeterminado es Grok Image Quality.
¿Grok Image admite imágenes de referencia o personajes?
Grok Image acepta image, additional_images. También admite personajes y referencias guardados mediante @handle en el prompt.
¿Puedo usar Grok Image desde Claude o ChatGPT?
Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide Grok Image por su nombre. Tu asistente consulta sus opciones con get_model y te indica el precio antes de generar.
¿Cuánto tiempo se conservan los resultados de Grok Image?
Los resultados y las entradas se conservan durante 30 días. Descarga lo que quieras guardar en tu propio almacenamiento.
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.