Grok Imagine Image Quality · API

Autenticación

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Crea una clave API en la consola para empezar.

Cuerpo de la petición

Ejemplo de petición

# 1) submit -> 202 {"id":"img_...","status":"queued"}
curl https://nezhagate.com/v1/images/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "grok-imagine-image-quality", "prompt": "a serene ink-wash poster, lots of negative space", "size": "1024x1536"}'
# 2) poll until status=succeeded
curl https://nezhagate.com/v1/images/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'

import time, requests

base, key = "https://nezhagate.com/v1", "YOUR_API_KEY"
h = {"Authorization": f"Bearer {key}"}
job = requests.post(f"{base}/images/generations", headers=h,
                    json={"model": "grok-imagine-image-quality", "prompt": "an ink-wash poster", "size": "1024x1536"}).json()
while True:
    r = requests.get(f"{base}/images/jobs/{job['id']}", headers=h).json()
    if r["status"] in ("succeeded", "failed"): break
    time.sleep(3)
print(r.get("data", [{}])[0].get("url"))

const base = "https://nezhagate.com/v1", key = "YOUR_API_KEY";
const h = { Authorization: `Bearer ${key}`, "Content-Type": "application/json" };
const job = await (await fetch(`${base}/images/generations`, { method: "POST", headers: h,
  body: JSON.stringify({ model: "grok-imagine-image-quality", prompt: "an ink-wash poster", size: "1024x1536" }) })).json();
let r;
do { await new Promise(s => setTimeout(s, 3000));
     r = await (await fetch(`${base}/images/jobs/${job.id}`, { headers: h })).json();
} while (r.status !== "succeeded" && r.status !== "failed");
console.log(r.data?.[0]?.url);

Respuesta

{
  "id": "img_3f9a...c2",
  "object": "image.generation.job",
  "status": "queued",
  "model": "grok-imagine-image-quality"
}

Imagen a imagen

Imagen a imagen: pon la referencia en `image` (una URL pública, un data: URI o base64 en bruto) para ejecutar una verdadera transformación que preserva la identidad: el modelo regenera a partir de ella con el tamaño y la proporción elegidos. Equivale a llamar a /v1/images/edits.

curl https://nezhagate.com/v1/images/generations -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "grok-imagine-image-quality", "prompt": "sustituye el fondo por un cielo estrellado", "image": "https://example.com/ref.png", "size": "3:4"}'

Trabajos de imagen (enviar → consultar el resultado)

Renderizar una imagen suele tardar entre 1 y 3 minutos, así que los endpoints de imagen funcionan solo por trabajos: al enviar una petición recibes al instante un id de trabajo (HTTP 202) y consultas el resultado con ese id. El servidor sigue renderizando aunque se reinicie, así que la imagen nunca se pierde. Funciona igual para texto a imagen y para imagen a imagen. (El antiguo campo "async": true ya no hace falta; se acepta pero se ignora.)

curl https://nezhagate.com/v1/images/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "grok-imagine-image-quality", "prompt": "un cartel de tinta china con mucho espacio negativo", "size": "3:4"}'

{ "id": "img_3f9a...c2", "object": "image.generation.job", "status": "queued", "model": "grok-imagine-image-quality" }

curl https://nezhagate.com/v1/images/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'

{
  "id": "img_3f9a...c2",
  "object": "image.generation.job",
  "status": "succeeded",
  "model": "grok-imagine-image-quality",
  "data": [{ "url": "https://img.nezhagate.com/i/9f86d081a8....png" }]
}

🕑 data[0].url es un enlace de nuestro alojamiento de imágenes que se conserva 60 días y después se elimina automáticamente; si necesitas seguir usándolo, descárgalo y guárdalo en tu propio almacenamiento o CDN.

status es queued / processing / succeeded / failed. Si tiene éxito, la respuesta lleva data[].url. Un trabajo solo lo puede consultar la cuenta que lo creó. Los endpoints de imagen son siempre asíncronos: al enviar recibes un id de trabajo; "async": true se acepta únicamente por compatibilidad y se ignora.

Códigos de error

Todo cuerpo de error incluye error.message / error.type / error.code / error.param: ramifica según code. La lista completa está en la guía de integración.