Formato del campo image en edición de imágenes Grok

Respuesta corta: image acepta la imagen o su enlace

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. En POST https://llmtr.com/v1/images/edits, el campo image no recibe un identificador de xAI: acepta la imagen mediante una URL o un data URI. Usa xai/grok-imagine-image o xai/grok-imagine-image-quality y conserva el prefijo data:image/ al enviar base64.

Para un archivo local, el valor tiene la forma data:image/<png|jpeg|webp|gif>;base64,... y reemplaza la URL. Para una referencia remota, puedes enviar una cadena HTTPS o un objeto con url. Si envías varias referencias, usa images con un arreglo de 1 a 5 imágenes; image corresponde a una sola imagen.

¿Qué formato tiene el campo image en la edición de imágenes de Grok?

El campo image de la edición de imágenes de Grok no usa un identificador. La documentación de xAI enumera 3 formas: URL pública, data URI base64 o file_id de xAI Files API; allí se usa file_id como término, no image id.

En LLMTR se aceptan una cadena HTTPS, un objeto con url, un objeto con type image_url y url, o un data URI base64 con png, jpeg, webp o gif. No se acepta un file_id de xAI Files API a través de LLMTR.

• xAI docs, Image editing · 2026-10-06

La solicitud en LLMTR: endpoint, modelos y campos

Envía la solicitud a POST /v1/images/edits. LLMTR ofrece este endpoint únicamente con xai/grok-imagine-image y xai/grok-imagine-image-quality. Usa prompt para indicar el cambio; response_format puede ser url o b64_json. Las URL de respuesta son temporales y LLMTR no amplía su vigencia durante la integración.

Selecciona resolution como 1k o 2k. Envía image para una sola imagen o images para un arreglo de 1 a 5 referencias. Si usas url, descarga el resultado de inmediato porque la URL es temporal; para conservarlo, solicita b64_json y guarda los bytes.

Ejemplo funcional con un archivo local y b64_json

El ejemplo lee product.png, convierte sus bytes en base64 y antepone data:image/png;base64, para enviar el archivo local como data URI. Usa xai/grok-imagine-image, response_format b64_json y POST /v1/images/edits. En image, type image_url contiene la URL del data URI generado en memoria.

La respuesta se guarda como edited.png o edited.jpg según los bytes recibidos. El código recupera data[0].b64_json, lo decodifica y lo escribe en un archivo local. Así conservas la imagen editada sin depender de una URL temporal posterior en tu sistema.

Ejemplo en Python que envía un archivo local como data URI y guarda la imagen editada usando b64_json.

import base64
import os
import requests

with open("product.png", "rb") as f:
    data_uri = "data:image/png;base64," + base64.b64encode(f.read()).decode()

response = requests.post(
    "https://llmtr.com/v1/images/edits",
    headers={"Authorization": f"Bearer {os.environ['LLMTR_API_KEY']}"},
    json={
        "model": "xai/grok-imagine-image",
        "prompt": "Keep the product, replace the background with a clean white studio",
        "image": {"type": "image_url", "url": data_uri},
        "response_format": "b64_json",
    },
    timeout=180,
)
response.raise_for_status()
image_bytes = base64.b64decode(response.json()["data"][0]["b64_json"])
extension = "png" if image_bytes[:4] == b"\x89PNG" else "jpg"
with open(f"edited.{extension}", "wb") as out:
    out.write(image_bytes)

Errores y coste

Una solicitud con un modelo de Google u OpenAI en /v1/images/edits devuelve 400 unsupported_operation. La generación de imágenes de referencia de Google se realiza en /v1/images/generations. En LLMTR, xai/grok-imagine-image cuesta 0,02 $ por imagen y xai/grok-imagine-image-quality cuesta 0,05 $ por imagen.

Una edición cuenta las imágenes enviadas y las producidas. Si xAI informa el costo real, la facturación sigue ese valor; cuando no lo informa, se aplica el precio por imagen. Esta regla debe tenerse en cuenta al estimar el consumo de una integración con varias referencias.

• xAI docs, Pricing · 2026-10-06

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

Paso 1: crea una cuenta en llmtr.com y verifica tu correo. Paso 2: recarga crédito desde el Dashboard con el pago seguro. El margen de plataforma del 8 % se añade una sola vez sobre la cantidad solicitada: por una recarga de 10,00 $, se cobran 10,80 $. No se suma a los precios de los modelos; cada llamada se descuenta al precio de catálogo.

Paso 3: crea una clave API en Dashboard > API Keys. La clave sin procesar se muestra una sola vez; guárdala como variable de entorno LLMTR_API_KEY. Paso 4: envía la primera solicitud a https://llmtr.com/v1 con cualquier SDK compatible con OpenAI y cambia solo base_url y api_key. El Dashboard muestra el uso y el gasto por clave. La misma clave y el mismo saldo sirven para todo el catálogo; cambiar de modelo significa modificar la cadena model.

Editar una imagen con Grok mediante LLMTR

Crea la cuenta y el crédito, genera una clave y envía una primera edición de imagen con un archivo local.

1. Crear la cuenta. Crea una cuenta en llmtr.com y verifica tu correo.
2. Recargar crédito. Recarga crédito desde el Dashboard mediante el pago seguro. El margen de plataforma del 8 % se añade una sola vez: por una recarga de 10,00 $, se cobran 10,80 $.
3. Crear la clave API. En Dashboard > API Keys, genera una clave API. La clave sin procesar se muestra una sola vez; guárdala como LLMTR_API_KEY.
4. Enviar la primera solicitud. Configura base_url como https://llmtr.com/v1 y api_key con LLMTR_API_KEY. Envía POST /v1/images/edits con xai/grok-imagine-image o xai/grok-imagine-image-quality.

Frequently asked questions

¿Qué formato usa el campo image en la edición de imágenes de Grok?

LLMTR acepta una URL HTTPS, un objeto con URL o un data URI base64. xAI documenta 3 formas, incluido file_id, pero LLMTR no acepta ese identificador.

¿Cuántas imágenes de referencia puede enviar una edición de Grok en LLMTR?

images acepta de 1 a 5 imágenes de referencia. Para una sola, usa image con una URL, un objeto con URL o un data URI base64 compatible.

¿Cuánto cuesta una edición de imágenes de Grok con LLMTR?

El coste es 0,02 $ o 0,05 $ por imagen, según el modelo. Se cuentan las imágenes enviadas y producidas; si xAI informa un costo, se factura ese valor.

Artículos relacionados

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

• Guía de generación de imágenes
• Catálogo de modelos
• Precios