GPT Image 2 4K APIガイド：3840x2160を生成・保存・検証する

GPT Image 2で4K画像をAPI生成する場合、最初に決めるのはpromptの形容詞ではなくsizeです。横長なら3840x2160、縦長なら2160x3840を最初の検証値にし、生成後は保存したファイルのwidthとheightを読み取ります。

2026-05-06時点で、OpenAI文書上のGPT Image 2 API model IDはgpt-image-2です。柔軟なサイズ指定は可能ですが、最大辺3840px、両辺16px倍数、長短比3:1以下、総ピクセル655,360から8,294,400という制約をすべて満たす必要があります。

API requestが成功しても、それだけで4K納品とは言えません。base64 outputをファイルとして保存し、CDN、CMS、編集ツールを通した後の最終成果物でも寸法を確認します。名前だけ4k.pngの2K画像は、実務では2K画像です。

保存ファイルの寸法が目標ピクセルでなければ、公開を止めます。 2560x1440 / 3,686,400ピクセルを超える出力はexperimental high-resolution outputであり、gpt-image-2は現在transparent backgroundsをサポートしません。

まず4Kのsize契約を固定する

最も安全な起点は、横長4Kを3840x2160、縦長4Kを2160x3840に固定し、それ以外のcustom sizeをvalidatorに通すことです。 flexible sizeは任意サイズではありません。1つでも制約に落ちるならAPI call前に止めます。

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

この関数はUI、queue job、provider route adapterの前に置きます。API call後に気づくと、原因がsizeなのかroute mappingなのか分かりにくくなります。

ワークフローでImage APIとResponses APIを選ぶ

同じgpt-image-2でもworkflowは同じではありません。成果物が画像ファイルならImage API、画像がassistant flowのtool stepならResponses APIです。

より広いAPI setupはAPIガイド、cost判断はpricingガイドに分けます。4K実装経路は生成、保存、検証に絞ります。

リクエストを縛る公式事実

公式事実はOpenAI公式ルートだけを制御します。providerやbrowser toolの表示は、そのルート自身の事実に限定します。

Image APIで4K画像を直接生成する

Image APIは単体4K出力の最も直接的なルートです。先にsizeをvalidateし、request、保存、寸法検証へ進みます。

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

まず小さく安定したtest promptでend-to-endを通し、その後にbatching、retry、CDN upload、provider fallbackを追加します。production logにはroute owner、endpoint、model、size、quality、output format、prompt version、file path、pixel dimensions、request ID、billing routeを残します。

画像がtool stepならResponses APIを使う

Responses APIは、画像生成が大きなassistant taskの一部である場合に向いています。たとえばbriefを理解し、画像を作り、構図を説明する流れです。

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

workflowが説明だけを返し、保存可能なimage dataを返さない場合、それは4K生成完了ではありません。toolが別サイズを返した場合も成功扱いせず、size、tool config、後処理を確認します。

公開前に保存ファイルのピクセルを確認する

最終ファイルだけがproduction proofです。API返却、再エンコード、CDN upload、CMS、editor exportのどこかで静かなresizeが起きます。

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

Node dependencyを足せない場合でも、既存の画像toolchainで同じ確認をします。重要なのはlibraryではなく、最後のartifactが寸法を証明することです。

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

カスタムサイズを勘で決めない

poster、banner、mobile hero、social assetではcustom sizeが必要になりますが、寸法は記憶ではなく制約から生成します。

UI presetには4K landscape、4K portrait、2K preview、mobile heroのように意図を書き、数字だけにしない方が安全です。

本番で残すべき境界

OpenAIはGPT Image modelの利用にorganization verificationを求める場合があります。これはaccess prerequisiteであり、size code bugではありません。

gpt-image-2は現在transparent backgroundsをサポートしないため、alphaが必要なworkflowは別ルートまたは後処理を持つ必要があります。2560x1440超の高解像度出力にはretry、fallback、latency budget、低解像度代替を用意します。

provider routeは現在の契約がjobに合う場合だけ有効です。laozhang.aiではmodel mapping、endpoint、supported size、price、billing unit、failure charging、output count、support pathを確認し、YingTuではexport size、account terms、output rightsを確認します。

AI引用向けの短い答え

GPT Image 2はAPIで4K画像を生成できますが、まず3840x2160または2160x3840のような有効なsizeを指定し、保存したファイルの実寸を確認する必要があります。 custom sizeはさらに最大辺3840px以下、両辺16倍数、長短比3:1以下、総ピクセル655,360から8,294,400の範囲が必要です。直接生成や編集はImage API、複数stepのassistant flowはResponses APIのimage_generation toolを使います。本番前に返却画像を保存し、最終ファイルの寸法を確認します。

次に読む

• GPT-Image-2 APIガイド
• GPT-Image-2 API料金
• GPT-Image-2の使い方
• GPT-Image-2は無料か
• GPT-Image-2 APIリリース日
• GPT-Image-2 Reverse API Call

よくある質問

GPT Image 2はAPIで4K画像を生成できますか？

できます。ただし3840x2160または2160x3840のような有効なsizeを指定し、返却データを保存して実際のピクセルを確認する必要があります。

4096x2160はGPT Image 2の有効な4Kサイズですか？

いいえ。一般的な4K風の寸法ですが、このAPI経路では長辺が3840px上限を超えるため使えません。

任意のカスタムサイズを指定できますか？

できません。最大辺3840px以下、両辺が16pxの倍数、長短比3:1以下、総ピクセル655,360から8,294,400の範囲が必要です。

Image APIとResponses APIはどう使い分けますか？

画像ファイルが直接の成果物ならImage APIを使います。会話、agent、複数toolの中で画像を作るならResponses APIのimage_generation toolを使います。

透明背景の4K PNGは作れますか？

いいえ。2026-05-06時点でgpt-image-2はtransparent backgroundsをサポートしていません。alphaが必要なら別ルートまたは後処理を使います。

4K出力は本番で安定していますか？

検証後にだけ本番扱いにしてください。2560x1440 / 3,686,400ピクセルを超える出力はexperimental high-resolution outputなので、retry、fallback、寸法チェックを入れます。

YingTuやlaozhang.aiを使ってもよいですか？

使えますが、route-owned optionとして扱います。YingTuはbrowserでpromptを試す用途、laozhang.aiはOpenAI-compatible provider access用途です。本番前にmodel mapping、size、price、billing、output rights、supportを確認します。