modelos

xAI: Grok Imagine Image 2.0

Markdown · JSON

xAI: Grok Imagine Image 2.0

Grok Imagine Image 2.0 crea imágenes a partir de encargos escritos y edita imágenes existentes mediante instrucciones en lenguaje natural. xAI documenta calidad, resolución y composición configurables, referencias de varias imágenes, transferencia de estilo y refinamiento iterativo.

Sobre el modelo

Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.

Grok Imagine Image 2.0 es el modelo de generación y edición de imágenes de xAI. Recibe una descripción escrita, o una descripción junto con imágenes de origen, y devuelve un resultado de imagen. El perfil denominado 2.0 del productor abarca crear una escena, cambiar una imagen existente, combinar sujetos de referencias y transformar el estilo visual. Empieza eligiendo si necesitas una composición nueva o un cambio específico en material que ya tienes.

Crear una imagen a partir de un encargo

Describe el sujeto principal, su entorno, la composición, la iluminación y el tratamiento visual. Identifica qué debe notar primero el espectador y dónde se utilizará la imagen. Para un concepto de producto, un encargo ilustrativo puede describir una lámpara de escritorio de cerámica sobre una mesa de piedra clara, luz suave de ventana, una vista cercana del material y espacio libre para un titular separado. Para una ilustración, especifica los personajes, la acción y la estética prevista en lugar de esperar que una sola palabra de estilo defina la escena completa.

El productor documenta de una a diez imágenes de salida por solicitud de generación, con una como valor predeterminado. Varios resultados del mismo encargo ofrecen alternativas que revisar; no garantizan un sujeto idéntico en todas las variaciones. Comprueba el sujeto, la composición y los detalles importantes y conserva después la versión que mejor corresponda al encargo. Mantén juntos el encargo y la variación seleccionada para que ediciones posteriores utilicen la composición prevista.

Composición, resolución y calidad

La guía de generación documenta selección automática de relación de aspecto o una relación explícita. Las opciones enumeradas incluyen 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, 21:9 y 5:2. Elige la forma según la ubicación prevista: cuadrada para una ficha compacta, vertical para una composición vertical u horizontal para una escena amplia. Especifica el sujeto sensible al recorte y el espacio que necesita la composición en lugar de depender solo de la relación de aspecto.

Los ajustes documentados de resolución de generación son 1k y 2k, con 1k como predeterminado. La calidad es un control independiente con opciones low, medium y auto. En la guía actual de xAI, auto es el valor predeterminado y utiliza low para generar y medium para editar; un ajuste explícito low o medium fija esa elección. Por tanto, la resolución y la calidad describen controles diferentes. Indica los detalles visuales importantes e inspecciónalos en la imagen devuelta en lugar de tratar cualquiera de los ajustes como garantía de letras, geometría o conservación del sujeto exactas.

Editar y transferir el estilo visual

Proporciona la imagen que cambiar y describe el cambio solicitado en relación con su contenido visible. Una edición enfocada podría pedir sustituir una pared oscura por una superficie de yeso clara mientras conserva la disposición del mobiliario, el punto de vista de cámara y la iluminación cálida. Si la intención es una transformación estilística, especifica el tratamiento deseado: el productor demuestra estilos de fotografía, anime, pintura al óleo, acuarela, pop art y boceto a lápiz. Identifica qué elementos deben conservar su aspecto y cuáles pueden cambiar con el tratamiento.

El flujo de edición del fabricante acepta una referencia de imagen de origen, datos de imagen codificados o un identificador de archivo. Para referencias almacenadas, utiliza imágenes PNG, JPEG o WebP subidas por completo. Su guía también documenta ediciones sucesivas: utiliza el resultado de una edición como entrada de la siguiente. Esto puede convertir una composición base en un resultado más específico mediante un cambio de mobiliario seguido de un ajuste de iluminación. Mantén el original y la imagen intermedia elegida asociados a cada encargo para poder comprobar un refinamiento posterior frente a la composición prevista.

Combinar varias referencias

La guía actual de múltiples imágenes permite hasta cinco imágenes de origen en una edición. Refiérete a ellas en el orden proporcionado y da a cada una una función clara, como el sujeto de la primera imagen y el entorno de la segunda. La relación de salida sigue por defecto la primera imagen de entrada, con una relación explícita disponible para sustituirla. Para un concepto de producto en una habitación, describe la posición, el tamaño y el contacto del producto con las superficies de la habitación y pide después conservar los detalles que lo identifican. Revisa cómo se combinaron las fuentes en lugar de suponer que todos los elementos se copiaron sin alteraciones.

Recibir y conservar la imagen

El productor devuelve por defecto una dirección temporal de imagen y también documenta salida de imagen codificada. Conserva pronto la imagen real cuando la necesites como recurso. Su flujo diferido opcional separa la confirmación de recepción de la solicitud de su finalización: a un identificador de solicitud le sigue un estado pending, done o failed, y los resultados diferidos utilizan el formato de respuesta de dirección con un periodo documentado de retención de 24 horas. Una solicitud enviada o un estado pendiente no son una imagen terminada. Conserva la imagen completada con su encargo y ajustes elegidos para reutilizarla después.

Un recurso final útil es una imagen que corresponde a un encargo definido de escena, composición o edición. Inspecciona la composición completa y sus pequeños detalles, especialmente el sujeto de origen, los límites de los objetos, las proporciones y cualquier texto que aporte significado. Para trabajo iterativo, cambia la instrucción asociada al problema visible y utiliza el resultado seleccionado como siguiente referencia. Mantén concretas las instrucciones de modificación deseada y conservación para poder evaluar cada resultado frente a una finalidad creativa específica.

Ailoot Ultra · Imágenes POST /v1/images/generations x-ai/grok-imagine-image-2.0

x-ai/grok-imagine-image-2.0

xAI /x-ai/grok-imagine-image-2.0

Primeros pasos

Grok Imagine Image 2.0 crea imágenes a partir de encargos escritos y edita imágenes existentes mediante instrucciones en lenguaje natural. xAI documenta calidad, resolución y composición configurables, referencias de varias imágenes, transferencia de estilo y refinamiento iterativo.

Entradas aceptadas
Texto · Imágenes
Resultados
Imágenes

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · Imágenes POST /v1/images/generations
Tipos de entrada
text, image
Tipos de salida
image
CampoTipoRequisitoValores y límitesPredeterminado
CampomodelTipostringRequisitoObligatorioValores y límites
x-ai/grok-imagine-image-2.0
Predeterminado—
CampopromptTipostringRequisitoObligatorioValores y límites
Longitud mínima: 1
Predeterminado—
CamporesolutionTipostringRequisitoOpcionalValores y límites
1K, 2K
Predeterminado—
Campoaspect_ratioTipostringRequisitoOpcionalValores y límites
1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto
Predeterminado—
CampoqualityTipostringRequisitoOpcionalValores y límites
low, medium
Predeterminado—
CamponTipointegerRequisitoOpcionalValores y límites
Mínimo: 1
Máximo: 1
Predeterminado—
Campoinput_referencesTipoarrayRequisitoOpcionalValores y límites
Número mínimo de elementos: 0
Número máximo de elementos: 3
Predeterminado—
CampoproviderTipoobjectRequisitoOpcionalValores y límitesPredeterminado—
Parámetros del método y ciclo de vida
ParámetroContrato
Parámetrocontent_typeContratoapplication/json
ParámetrorequiredContratomodel, prompt
Parámetromaterial_typesContratotext, image

Ciclo de vida: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · task_id real devuelto o registro de la biblioteca multimedia

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Planes

Cómo se calcula el cargo definitivo

Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen la cantidad facturable final.

Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.

Modo rápido
Sin especificar Cuando se selecciona el modo rápido
Modo flex
Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento
Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)

Tarifas estimadas para comparar

Precios por configuración

Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.

ConfiguraciónTabla de tarifasCantidad previstaUnidad de facturaciónCargo
ConfiguraciónTarifas base por tokenTabla de tarifasTarifa baseCantidad prevista—Unidad de facturación—Cargo
Entrada · Tokens de entrada · Estimación solo para comparar — / 1K tokens
Salida · Tokens de salida · Estimación solo para comparar — / 1K tokens
Entrada · Lectura de caché · Estimación solo para comparar — / 1K tokens
Entrada · Escritura en caché · Estimación solo para comparar — / 1K tokens
Entrada · Escritura en caché, 1 hora · Estimación solo para comparar — / 1K tokens
Configuraciónimagen de entradaTabla de tarifas—Cantidad prevista—Unidad de facturaciónpor imagen de entradaCargo
Entrada · imagen de entrada · Estimación solo para comparar $0.02 por imagen de entrada
ConfiguraciónCoste estimado de generaciónTabla de tarifas—Cantidad previstaestimación para una generaciónUnidad de facturación—Cargo
Salida · Coste estimado de generación · Estimación solo para comparar $0.08 estimación previa a la generación

Esta estimación no es un cargo adicional ni una tarifa fija para la generación completada.

Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →

Solicitudes de ejemplo

Ailoot Ultra · Imágenes

curl
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'x-ai/grok-imagine-image-2.0', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Recibir y guardar resultados

Ailoot Ultra · Imágenes

Descarga cada imagen recibida o guarda su contenido Base64

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Otras consultas de contenido
Consultar los archivos existentes que te pertenecen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Conserva todos los resultados completados

Guarda todas las imágenes completadas; descarga cada URL recibida o decodifica su contenido Base64.

Conserva la respuesta completa y las cabeceras, todas las salidas reales, los identificadores originales devueltos y todos los campos de uso. Recupera la operación original sin volver a enviar la solicitud de creación.

Si es necesario revisar la respuesta original

Conserva el X-Client-Request-ID devuelto para la conciliación. Consulta únicamente los valores task_id/asset_id realmente devueltos o la biblioteca multimedia propia; nunca construyas una URL de tarea a partir del ID de la operación ni vuelvas a enviar la solicitud de creación.

Campos de respuesta
CampoTipo
CampocreatedTipo
Campodata[].urlTipo
Campodata[].b64_jsonTipo
CampousageTipo

Alias

Alias del modelo

Ailoot Ultra x-ai/grok-imagine-image-2.0

Alias de rutas de métodos

/v1/images

ID de modelo relacionados

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0
¿Qué entradas y resultados están disponibles?

POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image

¿Qué campos utiliza la solicitud?

POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider

¿Qué límites se aplican?

POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

Más detalles

Conecta Ailoot a Claude Code, OpenCode, Hermes o tu aplicación.

La empresa y su cartera de proyectos

La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.

Compra tokens con descuento.

Ahorro por suscripción para trabajo habitual. Códigos promocionales: hasta el 50% al comprar tokens.

Suscripción
Elige un plan con descuento para tus peticiones habituales.
Código de hasta el 50%
Introduce el código al comprar. El precio se recalcula según la promoción vigente.
Gasto en el historial
Modelo, tokens e importe quedan guardados por cada petición.

Elegir suscripción · Consultar precios de modelos

Conecta la API al producto que vendes.

SaaS, aplicaciones y bots bajo la oferta y el acuerdo de licencia Ailoot. Solicita una licencia de reventa para redistribuir el acceso.

Aplicación comercial
Integra generación de texto, imágenes, vídeo y sonido en funciones de pago de tu servicio.
Licencia para revendedores
Envía descripción del proyecto y esquema de acceso. Solicita condiciones escritas de uso y reventa.
Documentos en la web
La oferta, el acuerdo de licencia y la política de datos están disponibles antes de conectar.

Solicitar licencia de reventa · Oferta y acuerdo de licencia