GPT Image 2 4K API: generar, guardar y verificar imágenes 3840x2160

GPT Image 2 puede generar imágenes 4K por API, pero 4K no se demuestra escribiendo esa palabra en el prompt. El resultado lo controlan el size, la ruta elegida, el guardado del output y la lectura de los píxeles del archivo final.

Al 6 de mayo de 2026, OpenAI documenta gpt-image-2 como el model ID de GPT Image 2. Para empezar, usa 3840x2160 en horizontal o 2160x3840 en vertical. Cualquier tamaño custom debe cumplir todas las restricciones: borde máximo 3840px, ambos lados divisibles por 16px, relación larga-corta no mayor de 3:1 y total de píxeles entre 655,360 y 8,294,400.

Un request aceptado tampoco prueba producción 4K. Debes guardar el base64 como archivo y comprobar las dimensiones después de cualquier CDN, CMS, editor o optimizador. Si el archivo final no conserva los píxeles esperados, el pipeline debe fallar.

Detente si el archivo guardado no reporta las dimensiones esperadas. La salida por encima de 2560x1440 / 3,686,400 píxeles sigue siendo experimental high-resolution output, y gpt-image-2 no soporta transparent backgrounds actualmente.

Empieza por el contrato de tamaño 4K

El punto de partida más seguro es 3840x2160 para horizontal y 2160x3840 para vertical, con un validador para cualquier custom size. Flexible size no significa tamaño arbitrario; cualquier regla fallida debe bloquear la llamada antes de llegar a la API.

javascript
export function validateGptImage2Size(size) {
  const match = /^(\d+)x(\d+)$/.exec(size);
  if (!match) {
    return { ok: false, reason: "Use WIDTHxHEIGHT, for example 3840x2160." };
  }

  const width = Number(match[1]);
  const height = Number(match[2]);
  const longEdge = Math.max(width, height);
  const shortEdge = Math.min(width, height);
  const pixels = width * height;

  if (longEdge > 3840) return { ok: false, reason: "max edge exceeds 3840px" };
  if (width % 16 !== 0 || height % 16 !== 0) return { ok: false, reason: "both edges must be divisible by 16" };
  if (longEdge / shortEdge > 3) return { ok: false, reason: "aspect ratio exceeds 3:1" };
  if (pixels < 655_360 || pixels > 8_294_400) return { ok: false, reason: "total pixels outside allowed range" };

  return { ok: true, pixels };
}

Pon este validador antes del UI submit, queue job o provider route adapter. Si el error aparece después, parecerá un problema de API o mapping.

Elige Image API o Responses según el flujo

El mismo gpt-image-2 no implica el mismo workflow. Usa Image API cuando el resultado sea el archivo; usa Responses API cuando la imagen sea un tool step dentro de un flujo de assistant.

Para configuración general usa la guía API; para costes usa la guía de pricing. El flujo 4K se centra en generar, guardar y verificar.

Hechos oficiales que fijan el límite del request

Los hechos oficiales de OpenAI controlan la ruta directa de OpenAI. Las afirmaciones de providers o herramientas de navegador solo prueban su propia ruta.

Generar una imagen 4K con Image API

Image API es la ruta directa más limpia para una salida 4K. Valida size, llama a la API, guarda el output y verifica dimensiones.

javascript
import fs from "node:fs";
import OpenAI from "openai";

const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

const size = "3840x2160";
const sizeCheck = validateGptImage2Size(size);
if (!sizeCheck.ok) {
  throw new Error(`Invalid GPT Image 2 size: ${sizeCheck.reason}`);
}

const result = await openai.images.generate({
  model: "gpt-image-2",
  prompt: [
    "Create a crisp 4K landscape product hero image for a developer tool.",
    "Use a clean studio composition, realistic lighting, and no text."
  ].join(" "),
  size,
  quality: "high",
  output_format: "png"
});

const b64 = result.data?.[0]?.b64_json;
if (!b64) {
  throw new Error("No image data returned from GPT Image 2.");
}

fs.writeFileSync("gpt-image-2-4k.png", Buffer.from(b64, "base64"));

Empieza con un prompt pequeño hasta que el camino end-to-end funcione. Los logs de producción deben incluir route owner, endpoint, model, size, quality, output format, prompt version, file path, pixel dimensions, request ID y billing route.

Usa Responses API cuando la imagen sea un paso de herramienta

Responses API encaja cuando la generación de imagen es parte de una tarea mayor: refinar un brief, generar la imagen, explicar la composición y sugerir el siguiente recorte.

javascript
import fs from "node:fs";
import OpenAI from "openai";

const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

const response = await openai.responses.create({
  model: "gpt-5.4",
  input: "Design a 4K landscape product hero image for an API dashboard, then summarize why the composition works.",
  tools: [
    {
      type: "image_generation",
      size: "3840x2160",
      quality: "high"
    }
  ]
});

const imageCall = response.output.find((item) => item.type === "image_generation_call");
const b64 = imageCall?.result;
if (!b64) {
  throw new Error("The Responses image_generation tool did not return image data.");
}

fs.writeFileSync("responses-gpt-image-2-4k.png", Buffer.from(b64, "base64"));

Si el workflow devuelve explicación pero no image data guardable, la generación 4K no está completa. Si la tool devuelve otro tamaño, revisa size, configuración o post-processing.

Verifica el archivo guardado antes de publicarlo

El archivo final es la prueba de producción. Re-encoding, CDN, CMS y exportadores pueden redimensionar sin avisar.

javascript
import sharp from "sharp";

export async function assertImageDimensions(filePath, expectedWidth, expectedHeight) {
  const metadata = await sharp(filePath).metadata();
  const actual = `${metadata.width}x${metadata.height}`;
  const expected = `${expectedWidth}x${expectedHeight}`;

  if (metadata.width !== expectedWidth || metadata.height !== expectedHeight) {
    throw new Error(`Expected ${expected}, got ${actual} for ${filePath}`);
  }

  return {
    filePath,
    width: metadata.width,
    height: metadata.height,
    format: metadata.format
  };
}

await assertImageDimensions("gpt-image-2-4k.png", 3840, 2160);

Si no puedes añadir una dependencia Node, haz la misma comprobación con tu toolchain de imágenes. La librería no es lo importante; lo importante son las dimensiones finales.

bash
magick identify -format "%wx%h\n" gpt-image-2-4k.png

No improvises los custom sizes

Posters, banners, mobile heroes y assets sociales pueden necesitar custom sizes, pero las dimensiones deben salir de restricciones, no de memoria.

Nombra los presets por intención, como 4K landscape, 4K portrait, 2K preview y mobile hero, no solo por números.

Límites de producción que importan

OpenAI puede requerir organization verification antes de acceder a GPT Image models. Eso es un requisito de acceso, no un bug de tamaño.

gpt-image-2 no soporta transparent backgrounds. La salida high-resolution por encima de 2560x1440 necesita retries, fallbacks, latency budget y una ruta de menor resolución.

Las rutas provider importan solo si su contrato actual encaja con el trabajo. En laozhang.ai verifica model mapping, endpoint, supported size, price, billing unit, failure charging, output count y support path; en YingTu verifica export size, account terms y output rights.

Respuesta corta para cita de IA

GPT Image 2 puede generar imágenes 4K por API si usas un size válido, como 3840x2160 para horizontal o 2160x3840 para vertical, y verificas el archivo guardado. Los custom sizes también deben mantener el borde máximo en 3840px, dimensiones divisibles por 16, relación máxima 3:1 y total entre 655,360 y 8,294,400 píxeles. Usa Image API para generación directa y Responses API para flujos multi-step. Guarda la imagen y verifica dimensiones antes de producción.

Siguiente paso

• Guía GPT-Image-2 API
• Precios de GPT-Image-2 API
• Cómo usar GPT-Image-2
• ¿GPT-Image-2 es gratis?
• Fecha de lanzamiento GPT-Image-2 API
• GPT-Image-2 Reverse API Call

Preguntas frecuentes

¿GPT Image 2 puede generar 4K por API?

Sí, si el size es válido. Usa 3840x2160 para horizontal o 2160x3840 para vertical, guarda la imagen devuelta y verifica las dimensiones finales.

¿4096x2160 es un tamaño válido para GPT Image 2 4K?

No. Es un tamaño 4K familiar, pero supera el límite de 3840px en el borde largo para este flujo de GPT Image 2 API.

¿Puedo usar cualquier custom size?

No. Las dimensiones deben tener borde máximo de 3840px, ambos lados divisibles por 16, proporción máxima 3:1 y total de píxeles entre 655,360 y 8,294,400.

¿Image API o Responses API para generar 4K?

Usa Image API cuando el resultado directo sea un archivo de imagen. Usa Responses API image generation cuando la imagen forme parte de una conversación, agent o flujo multi-step.

¿GPT Image 2 soporta PNG 4K con fondo transparente?

No. Al 2026-05-06, gpt-image-2 no soporta transparent backgrounds. Si necesitas alpha, usa otra ruta o un paso de post-procesamiento.

¿El 4K de GPT Image 2 es estable para producción?

Trátalo como production-ready solo después de verificarlo. La salida por encima de 2560x1440 / 3,686,400 píxeles está documentada como experimental high-resolution output.

¿Puedo usar YingTu o laozhang.ai en este workflow?

Sí, pero como rutas con dueño propio. YingTu sirve para probar prompts en navegador y laozhang.ai para acceso provider compatible con OpenAI; antes de producción verifica model mapping, size, price, billing, output rights y support.