Guías de integración · 2026-10-06

xAI API: grok-imagine-image-quality, aspect_ratio y b64_json

Usa la API de xAI en LLMTR para generar imágenes con grok-imagine-image-quality, aspect_ratio, resolution y b64_json en /v1/images/generations.

Diagrama simple de Grok Imagine: solicitud con aspect_ratio y resolution, respuesta JSON con b64_json y archivo de imagen decodificado.

Respuesta corta: endpoint, modelo y respuesta base64

LLMTR (llmtr.com) es una pasarela que da acceso a modelos de lenguaje alojados en Turquía y en proveedores globales a través de una única API compatible con OpenAI. Usa https://llmtr.com/v1 y envía POST /v1/images/generations con Authorization: Bearer, el modelo xai/grok-imagine-image-quality y response_format: b64_json para recibir la imagen como base64 en data[0].b64_json.

En LLMTR, aspect_ratio es una cadena como "16:9" o "1:1" y se transmite a xAI sin cambios. resolution acepta "1k" o "2k"; cualquier otro valor devuelve 400. response_format permite "b64_json" o "url". Con b64_json, decodifica data[0].b64_json y guarda los bytes como archivo. Para editar una imagen existente, usa POST /v1/images/edits.

Campos de la solicitud para xai/grok-imagine-image-quality en POST /v1/images/generations
CampoValores aceptadosNota
modelxai/grok-imagine-image-quality or xai/grok-imagine-image$0.05 o $0.02 por imagen
prompttexto, obligatoriodescribe la imagen
aspect_ratiocadena de proporción como "16:9" o "1:1"se envía a xAI tal como está escrita
resolution"1k" o "2k"otros valores devuelven 400
response_format"b64_json" o "url"las URL son de corta duración
nnúmero de imágenescada imagen se factura

API de xAI para generar imágenes: aspect_ratio, grok-imagine-image-quality y b64_json

Para generar imágenes con xAI desde LLMTR, llama a https://llmtr.com/v1/images/generations con xai/grok-imagine-image-quality. Envía aspect_ratio como "16:9" o "1:1", resolution como "1k" o "2k" y response_format como "b64_json" o "url". Con fecha 2026-10-06, xAI indica 0,05 $ por imagen para el modelo de calidad y 0,02 $ para el estándar.

El endpoint requiere Authorization: Bearer con una clave LLMTR. aspect_ratio llega a xAI exactamente como lo escribes; la documentación de xAI contiene las proporciones aceptadas. resolution admite "1k" o "2k", también 1K/2K en mayúsculas, y rechaza otros valores con 400. response_format acepta "b64_json" o "url"; LLMTR recomienda b64_json porque las URL son de corta duración.

Ejemplo completo con curl

El siguiente curl llama a https://llmtr.com/v1/images/generations con Authorization: Bearer $LLMTR_API_KEY. Envía xai/grok-imagine-image-quality, un prompt de producto, aspect_ratio: "16:9", resolution: "1k", response_format: "b64_json" y n: 1. La imagen llega dentro del JSON como base64, lista para decodificarse y guardarse localmente con Python o cualquier otro lenguaje.

Ejecuta el bloque después de exportar LLMTR_API_KEY. Puedes sustituir el prompt de producto por el texto de tu imagen. data[0].b64_json contiene el resultado en base64, mientras n define cuántas imágenes se generan y facturan. Para editar una imagen existente, usa POST https://llmtr.com/v1/images/edits.

Solicitud curl para generar una imagen de producto en 16:9 y recibirla como b64_json.

curl https://llmtr.com/v1/images/generations \
  -H "Authorization: Bearer $LLMTR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "xai/grok-imagine-image-quality",
    "prompt": "Product photo of a ceramic coffee cup on a wooden table, soft morning light",
    "aspect_ratio": "16:9",
    "resolution": "1k",
    "response_format": "b64_json",
    "n": 1
  }'

Writing b64_json to a file

El bloque Python envía una solicitud a https://llmtr.com/v1/images/generations con xai/grok-imagine-image-quality. Lee response.json()["data"][0]["b64_json"], decodifica el valor base64 y escribe los bytes en cup.jpg. La llamada incluye un tiempo de espera de 120 segundos; cambia el nombre del archivo si lo necesitas.

Con response_format: "b64_json", data[0].b64_json es el campo que contiene la imagen en base64. La alternativa response_format: "url" devuelve una dirección alojada por xAI que es de corta duración. Usa b64_json para obtener los bytes directamente y guardarlos sin depender de esa dirección.

Python para decodificar data[0].b64_json y guardar la imagen generada en un archivo local.

import base64
import os

import requests

response = requests.post(
    "https://llmtr.com/v1/images/generations",
    headers={"Authorization": f"Bearer {os.environ['LLMTR_API_KEY']}"},
    json={
        "model": "xai/grok-imagine-image-quality",
        "prompt": "Product photo of a ceramic coffee cup on a wooden table, soft morning light",
        "aspect_ratio": "16:9",
        "resolution": "1k",
        "response_format": "b64_json",
        "n": 1,
    },
    timeout=120,
)
response.raise_for_status()
image_bytes = base64.b64decode(response.json()["data"][0]["b64_json"])
with open("cup.jpg", "wb") as file:
    file.write(image_bytes)

Calidad o estándar: precio por imagen y coste total

xai/grok-imagine-image-quality cuesta 0,05 $ por imagen y xai/grok-imagine-image cuesta 0,02 $ por imagen. La página de precios de xAI está fechada el 2026-10-06, y LLMTR factura el coste que xAI informa para la solicitud. El modelo de calidad cuesta 2,5 veces el precio del estándar. La comparación corresponde al coste por imagen.

n multiplica el coste porque cada imagen se factura. Con el modelo de calidad, n = 4 cuesta 4 x 0,05 $ = 0,20 $. Para 1.000 imágenes, el modelo de calidad cuesta 50,00 $ y el estándar cuesta 20,00 $. Las ediciones pasan por POST https://llmtr.com/v1/images/edits, disponible en LLMTR para los modelos de imagen de xAI.

Empezar en LLMTR: cuenta, crédito, clave y primera solicitud

Paso 1: crea una cuenta en llmtr.com y verifica tu correo electrónico. Paso 2: añade crédito desde el Dashboard mediante el checkout seguro. El margen de plataforma del 8% se aplica una sola vez: una recarga de 10,00 $ se cobra 10,80 $. El margen no se añade a los precios de los modelos; cada llamada API se descuenta al precio de catálogo.

Paso 3: en Dashboard > API Keys, crea una clave API. La clave sin procesar se muestra una sola vez; guárdala como LLMTR_API_KEY. Paso 4: envía la primera solicitud a https://llmtr.com/v1 con un SDK compatible con OpenAI y cambia solo base_url y api_key. El uso y el gasto por clave aparecen en la página de uso del Dashboard. La misma clave y el mismo saldo sirven para todos los modelos; cambia el identificador para usar otro.

Configurar la primera generación de imágenes con xAI

Crea tu cuenta, añade crédito y usa una clave API para enviar una solicitud a LLMTR.

  1. Cuenta. Crea una cuenta en llmtr.com y verifica tu correo electrónico.
  2. Recarga de crédito. Añade crédito desde el Dashboard mediante el checkout seguro. Se aplica una sola vez un margen de plataforma del 8% sobre la recarga: 10,00 $ de crédito se cobran 10,80 $. El margen no se añade a los precios de los modelos; cada llamada API se descuenta al precio de catálogo.
  3. Clave API. En Dashboard > API Keys, crea una clave API. La clave sin procesar se muestra una sola vez; guárdala en una variable como LLMTR_API_KEY.
  4. Primera solicitud. Envía la primera solicitud a https://llmtr.com/v1 con cualquier SDK compatible con OpenAI: cambia solo base_url y api_key. El uso y el gasto por clave aparecen en la página de uso del Dashboard. La misma clave y el mismo saldo funcionan para todos los modelos del catálogo; cambia el identificador del modelo para usar otro.

Frequently asked questions

¿Es mejor usar url o b64_json para una imagen?

Usa b64_json. La respuesta url apunta a una dirección alojada por xAI que es de corta duración; b64_json mantiene la imagen como datos base64 dentro de la respuesta.

¿Qué valores acepta resolution en la API de imágenes?

resolution acepta "1k" o "2k"; cualquier otro valor devuelve 400. La forma en mayúsculas 1K/2K también se acepta.

¿Cuánto cuesta xai/grok-imagine-image-quality por imagen?

xai/grok-imagine-image-quality cuesta 0,05 $ por imagen y xai/grok-imagine-image cuesta 0,02 $ por imagen. El modelo de calidad cuesta 2,5 veces el estándar.

Artículos relacionados