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.
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.
| Campo | Valores aceptados | Nota |
|---|---|---|
| model | xai/grok-imagine-image-quality or xai/grok-imagine-image | $0.05 o $0.02 por imagen |
| prompt | texto, obligatorio | describe la imagen |
| aspect_ratio | cadena 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 |
| n | número de imágenes | cada 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.
- Cuenta. Crea una cuenta en llmtr.com y verifica tu correo electrónico.
- 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.
- 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.
- 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.