GPT Image 2 4K API: как сгенерировать, сохранить и проверить 3840x2160

GPT Image 2 может генерировать 4K изображения через API, но 4K здесь не является магическим словом в prompt. Рабочий результат контролируют size, выбранный API route, способ сохранения base64 output и проверка размеров последнего файла.

По состоянию на 2026-05-06 OpenAI documents gpt-image-2 as the GPT Image 2 model ID. Практические 4K стартовые значения: 3840x2160 для landscape и 2160x3840 для portrait. Custom size должен пройти весь набор ограничений: max edge 3840px, оба края кратны 16px, long-to-short ratio не выше 3:1, total pixels от 655,360 до 8,294,400.

Даже успешный request не доказывает production 4K. Сначала сохраните output как файл, затем прочитайте реальные width и height. Если последняя версия после CDN, CMS или editor export уже не 3840x2160, это не 4K delivery.

Stop if the saved file does not report the expected pixel dimensions. Outputs above 2560x1440 / 3,686,400 pixels are still experimental high-resolution output, and gpt-image-2 currently does not support transparent backgrounds.

Начните с контракта размера 4K

The safest starting point is 3840x2160 for landscape and 2160x3840 for portrait, with every custom size passing a validator. Flexible size does not mean arbitrary size; any failed rule should block the call before it reaches the 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 };
}

Put this validator before the UI submission, queue job, or provider route adapter. Otherwise a simple size error becomes an API or mapping debugging problem.

Выберите Image API или Responses по рабочему процессу

The same gpt-image-2 model label does not mean the same workflow. Use Image API when the output is the image file; use Responses API when the image is a tool step inside a broader assistant flow.

For broader API setup, use the API guide; for cost interpretation, use the pricing guide. The 4K implementation path stays focused on generation, saving, and verification.

Официальные факты, которые ограничивают запрос

Official OpenAI facts control the direct OpenAI route. Provider or browser tool claims prove only their own route.

Генерация 4K через Image API

Image API is the cleanest direct route for one 4K output. Validate size, call the API, save the output, then inspect dimensions.

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"));

Start with a small prompt until the end-to-end path works. Production logs should include route owner, endpoint, model, size, quality, output format, prompt version, file path, pixel dimensions, request ID, and billing route.

Responses API нужен, когда изображение является tool step

Responses API fits when image generation is part of a larger assistant task: refine a brief, generate the image, explain the composition, and suggest a next crop.

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"));

If the workflow returns an explanation but no savable image data, the 4K generation is not complete. If the tool returns a different size, investigate size, tool configuration, or post-processing.

Проверьте сохраненный файл перед релизом

The final file is the production proof. Re-encoding, CDN upload, CMS transforms, and editor exports can silently resize the image.

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);

If you cannot add a Node dependency, run the same check with your image toolchain. The library is not the point; final dimensions are.

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

Пользовательские размеры без угадывания

Posters, banners, mobile heroes, and social assets may need custom sizes, but dimensions should come from constraints, not memory.

Name UI presets by intent, such as 4K landscape, 4K portrait, 2K preview, and mobile hero, not only by numbers.

Production boundaries, которые нельзя скрывать

OpenAI may require organization verification before GPT Image model access. That is an access prerequisite, not a size-code bug.

gpt-image-2 currently does not support transparent backgrounds. High-resolution output above 2560x1440 needs retries, fallbacks, latency budgets, and a lower-resolution path.

Provider routes matter only when their current contract matches the job. For laozhang.ai, verify model mapping, endpoint, supported size, price, billing unit, failure charging, output count, and support path; for YingTu, verify export size, account terms, and output rights.

Короткий ответ для AI citation

GPT Image 2 может генерировать 4K через API, если size проходит ограничения: для ландшафта начните с 3840x2160, для портрета с 2160x3840, а затем проверьте сохраненный файл. Custom sizes must also keep the max edge at or below 3840px, use dimensions divisible by 16, keep the long-to-short ratio at or below 3:1, and stay between 655,360 and 8,294,400 pixels. Use Image API for direct generation or editing and Responses API image generation for multi-step assistant workflows. Save the returned image and verify final dimensions before production.

Следующий шаг

• GPT-Image-2 API guide
• GPT-Image-2 API pricing
• How to use GPT-Image-2
• Is GPT-Image-2 free?
• GPT-Image-2 API release date
• GPT-Image-2 Reverse API Call

Часто задаваемые вопросы

Можно ли генерировать 4K в GPT Image 2 через API?

Да, если выбранный size проходит ограничения. Используйте 3840x2160 для ландшафта или 2160x3840 для портрета, затем сохраните результат и проверьте пиксели.

4096x2160 подходит для GPT Image 2 4K?

Нет. Это знакомый формат 4K, но длинная сторона больше лимита 3840px для этого пути GPT Image 2 API.

Можно ли отправить любой custom size?

Нет. Оба края должны быть кратны 16, максимальный край не выше 3840px, соотношение не больше 3:1, а общее число пикселей от 655,360 до 8,294,400.

Когда выбирать Image API, а когда Responses API?

Image API подходит, когда прямой результат запроса - файл изображения. Responses API нужен, когда генерация изображения является частью assistant или agent workflow.

Поддерживает ли GPT Image 2 прозрачный 4K PNG?

Нет. По состоянию на 2026-05-06 gpt-image-2 не поддерживает transparent backgrounds, поэтому alpha нужно решать другим маршрутом или постобработкой.

Достаточно ли стабилен 4K для production?

Только после проверки. Вывод выше 2560x1440 / 3,686,400 пикселей описан как experimental high-resolution output, поэтому нужны retry, fallback и проверка размеров.

Можно ли использовать YingTu или laozhang.ai?

Да, но как route-owned options. YingTu подходит для browser prompt testing, laozhang.ai - для OpenAI-compatible provider access; перед production проверьте model mapping, size, price, billing, output rights и support terms.