Generación de imágenes GPT-Image-2

gpt-image-2 admite generación y edición con imágenes de referencia para imágenes de producto, borradores de carteles, ilustraciones, recursos sociales, visuales de alta resolución, transferencia de estilo y fusión de varias referencias.

POST https://api.apihop.ai/openai/v1/images/generations

Autenticación

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Inicio rápido

{
  "model": "gpt-image-2",
  "prompt": "A minimal black wireless earbud product poster on a white background, clean studio lighting, no text",
  "n": 1,
  "size": "2048x1152",
  "resolution": "2k",
  "quality": "low"
}

Alcance de la comparación de precios

Los niveles de imagen 1K / 2K / 4K publicados por RequestBeam son *precios de venta de RequestBeam*, no tarifas oficiales fijas de OpenAI por imagen. La documentación de precios de OpenAI describe cargos por tokens de imagen/texto y niveles de procesamiento; el coste real depende del tamaño, calidad, referencias de entrada y salida. Compararlos solo porque ambos mencionan 1k o 2k no es un cálculo de descuento entre conceptos equivalentes.

Para evitar afirmaciones de ahorro sin fundamento, la antigua referencia de proveedor agregado USD per image y la insignia de descuento se ocultan deliberadamente para GPT Image 2. El precio de RequestBeam sigue visible y el contrato de facturación no cambia. Para una comparación futura justificable, registra el modelo exacto, endpoint, calidad, tamaño, condiciones de entrada, URL de la fuente oficial y fecha de verificación. Comprueba el precio efectivo de tu cuenta antes de una llamada de pago.

Cuerpo

Imágenes de referencia y edición

La edición con imágenes de referencia usa el mismo endpoint JSON. Añade image_urls y describe qué conservar y cambiar en prompt:

{
  "model": "gpt-image-2",
  "prompt": "Keep the product unchanged, replace the background with a dark blue studio, and add soft rim lighting",
  "image_urls": [
    "https://example.com/product.png"
  ],
  "size": "1:1",
  "resolution": "2k"
}

Varias referencias pueden aportar el sujeto, la composición o el estilo visual:

{
  "model": "gpt-image-2",
  "prompt": "Use the product from the first image and the composition from the second image to create a clean ecommerce hero image",
  "image_urls": [
    "https://example.com/product.png",
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  ],
  "size": "4:3",
  "resolution": "2k"
}

Límites del contrato público actual:

• La edición de imagen completa, transferencia de estilo y fusión de varias referencias se admiten mediante image_urls.
• No existe una ruta independiente POST https://api.apihop.ai/openai/v1/images/edits.
• No se aceptan subidas multipart/form-data. Convierte primero las imágenes locales a URI de datos Base64 o súbelas a URL accesibles.
• No se admite rellenado con máscara. Enviar mask, mask_url o maskUrl devuelve 400 antes de reservar saldo.

Ejemplos de solicitudes

Imagen de producto 1:1

{
  "model": "gpt-image-2",
  "prompt": "A transparent glass cup on a light gray background, commercial product photography, soft shadow, no text",
  "n": 1,
  "size": "1024x1024",
  "resolution": "1k",
  "quality": "low",
  "output_format": "png"
}

Cartel 16:9

{
  "model": "gpt-image-2",
  "prompt": "A futuristic city night poster with neon lights, wet streets, cinematic composition, no text",
  "n": 1,
  "size": "2048x1152",
  "resolution": "2k",
  "quality": "medium",
  "output_format": "jpeg"
}

Cómo se devuelven los resultados

Este endpoint compatible con OpenAI no devuelve primero una respuesta de envío de tarea con data.jobId para consultarla después:

• Con stream: false, la solicitud HTTP actual espera hasta la finalización y devuelve las URL de imágenes en la respuesta JSON.
• Con stream: true, la conexión SSE actual permanece abierta hasta image_generation.completed y [DONE].

No uses GET https://api.apihop.ai/v1/jobs/{id} para obtener resultados de este endpoint. Usa Consultar tarea asíncrona solo cuando un endpoint de creación asíncrona devuelva explícitamente un jobId.

Respuesta sin streaming

La respuesta contiene URL de imágenes. Se incluye usage cuando la ruta del proveedor aporta información de medición.

{
  "created": 1777270000,
  "data": [
    {
      "url": "https://image.example.com/generated/123456789012345678/0.png"
    }
  ],
  "usage": {
    "input_tokens": 20,
    "output_tokens": 1234,
    "total_tokens": 1254
  }
}

Respuesta en streaming

event: image_generation.completed
data: {"type":"image_generation.completed","data":[{"index":0,"url":"https://image.example.com/generated/123456789012345678/0.png"}],"usage":{"input_tokens":20,"output_tokens":1234,"total_tokens":1254}}

data: [DONE]

Referencia de tamaños

Respuesta de error

Consulta Códigos de error y resolución de problemas para la referencia completa de códigos, diferencias de protocolo y pasos de diagnóstico.

{
  "code": 10000,
  "message": "prompt is required",
  "type": "api_error"
}

Errores habituales:

• 400: faltan parámetros obligatorios o la combinación no es compatible
• 401: fallo de autenticación o clave de API incorrecta
• 402: saldo insuficiente
• 404: el modelo no existe o no está activado
• 429: límite de velocidad superado
• 5xx: servicio temporalmente no disponible o fallo de generación de imágenes