Documentación de la API de GPT Image Hub

Todos los puntos finales v1, excepto el listado de modelos, requieren una clave API en el encabezado Authorization. La clave sin formato se muestra una vez en el momento de la creación; el servidor almacena solo un hash.

Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

El punto final de los modelos devuelve ID de modelo, proveedores, relaciones de aspecto admitidas, calidades admitidas, límites de imágenes de referencia y créditos por imagen.

curl https://www.gptimagehub.com/api/v1/models

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image-turbo",
    "prompt": "A cinematic product photo with premium studio lighting",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

El punto final de créditos devuelve el saldo, el tipo de cuenta y el próximo vencimiento del crédito para el usuario propietario de la clave API.

curl https://www.gptimagehub.com/api/v1/credits \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

De forma predeterminada, el punto final de generación de imágenes espera a que termine la generación. Establezca async en true para recibir de inmediato un id de generación y consultar /api/v1/generations/:generationId hasta obtener el resultado. Los créditos se cobran antes de la generación en el proveedor y se reembolsan automáticamente cuando el proveedor falla o devuelve menos imágenes de las solicitadas.

Solicitud JSON

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cinematic product photo of a transparent perfume bottle on black marble",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

Tarea asíncrona

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-hero-image" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cinematic product photo with premium studio lighting",
    "size": "1024x1024",
    "quality": "high",
    "n": 1,
    "async": true
  }'

{
  "object": "image_generation",
  "id": "clx_generation_log_id",
  "status": "queued",
  "model": "gpt-image-2",
  "aspect_ratio": "1:1",
  "quality": "1K",
  "created_at": "2026-04-30T08:00:00.000Z",
  "images": [],
  "usage": {
    "credits": 0,
    "credits_requested": 7
  },
  "poll_url": "https://www.gptimagehub.com/api/v1/generations/clx_generation_log_id"
}

Solicitud de imagen de referencia

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -F "model=gpt-image-2" \
  -F "prompt=Use the reference image and render it as a premium studio product shot" \
  -F "size=1024x1024" \
  -F "quality=high" \
  -F "n=1" \
  -F "reference_image=@./reference.png"

Respuesta

{
  "object": "image_generation",
  "id": "clx_generation_log_id",
  "status": "succeeded",
  "model": "gpt-image-2",
  "aspect_ratio": "1:1",
  "quality": "1K",
  "images": [
    {
      "id": "clx_image_id",
      "object": "image",
      "url": "https://cdn.example.com/generations/user/image.png",
      "created_at": "2026-04-30T08:00:00.000Z"
    }
  ],
  "usage": {
    "credits": 7
  },
  "balance": {
    "credits": 113,
    "account_type": "PRO",
    "next_expiration": null
  }
}

Utilice el id devuelto por el punto final de generación para recuperar su registro guardado y las URL de las imágenes. Las claves API solo pueden leer generaciones propiedad del mismo usuario.

curl https://www.gptimagehub.com/api/v1/generations/clx_generation_log_id \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "error": {
    "message": "Invalid request body",
    "code": "invalidRequest"
  }
}

• La generación síncrona puede ejecutarse durante un máximo de 800 segundos en producción.
• n debe estar entre 1 y 4.
• Las imágenes de referencia admiten PNG, JPG, JPEG y WebP. La solicitud completa, incluida cada imagen de referencia, debe ser inferior a 4.5MB (mantenga las imágenes por debajo de 4MB en total). Las solicitudes más grandes son rechazadas por la plataforma de alojamiento con un 413 en texto plano antes de llegar a la API, por lo que debe redimensionar o comprimir las imágenes primero.
• La cantidad máxima de imágenes de referencia está definida por el reference_image_limit de cada modelo.
• Límites de tasa: 60 solicitudes de generación por minuto por API key y 120 por minuto por dirección IP. Cada respuesta incluye los encabezados RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset; una respuesta 429 también incluye Retry-After.
• Para reintentar una generación de forma segura, envíe un encabezado Idempotency-Key (de hasta 120 caracteres). Repetir la misma clave con la misma API key devuelve la generación original en lugar de cobrar nuevamente.
• El modo asíncrono devuelve 202 con poll_url. Los webhooks aún no están disponibles.