API de Mage · Modelo de imagen

API de Grok Image

Grok Imagine en tres niveles de calidad

Obtén una clave de APIPrueba Grok Image en el playground
POST https://api.mage.space/v1/grok_image/generate

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.

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_idNombrePredeterminado
grok-imagine-imageGrok Image
grok-imagine-image-qualityGrok Image QualitySí
grok-imagine-image-2.0Grok 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.

CampoValores
aspect_ratio1: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
resolution1k, 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.

CampoRol
imageLa imagen de referencia.
additional_imagesImá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.

Obtén una clave de APIPrueba Grok Image en el playground

Relacionado