GPT-Image-2 API 指南：OpenAI Image API、Responses 工具、价格和供应商边界

GPT-Image-2 API 现在有清晰的一方路线：图片是直接产物时用 OpenAI Image API；图片生成属于助手、agent 或多步流程时，用 Responses API 的 image_generation 工具。 不要把官方路线和供应商路线写成同一个合同。OpenAI 的价格、模型 ID、组织验证、尺寸限制和输出格式是一手事实；laozhang.ai 的 gpt-image-2 $0.03/call 是供应商合同，适合网关或支付场景，但不是 OpenAI 官方价格。

本文已在 OpenAI 发布 GPT Image 2 模型页和价格证据后重写。旧的等待发布写法不再是当前合同。

快速答案

官方证据

API 页的关键不是把所有 endpoint 堆在一起，而是先决定 Image API 还是 Responses。前者适合直接图片产物，后者适合多步助手流程。

先选 Image API 还是 Responses

最小可用调用

javascript
import OpenAI from "openai";
const openai = new OpenAI();

const result = await openai.images.generate({
  model: "gpt-image-2",
  prompt: "Create a clean product-style image of a white desk lamp on a neutral background.",
  size: "1536x1024",
  quality: "medium",
  output_format: "webp"
});

const imageBase64 = result.data[0].b64_json;

编辑图片时使用 /v1/images/edits 并上传 image；多图参考也走 edit 语义。Responses 示例则用 model: "gpt-5.4" 这类主模型，并挂载 tools: [{ type: "image_generation" }]。关键边界：gpt-image-2 是 GPT Image 模型，不是 Responses 的主模型字段。

实现模式：生成、编辑、Responses、streaming

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

const openai = new OpenAI();

const edit = await openai.images.edit({
  model: "gpt-image-2",
  image: fs.createReadStream("input.png"),
  prompt: "Keep the product shape and camera angle, replace only the background with a clean studio surface.",
  size: "1536x1024",
  quality: "medium",
  output_format: "webp"
});

const editedImageBase64 = edit.data[0].b64_json;

javascript
const response = await openai.responses.create({
  model: "gpt-5.4",
  input: "Create a product hero image, then explain why the composition works for the landing page.",
  tools: [{ type: "image_generation", partial_images: 2 }]
});

const imageCalls = response.output.filter((item) => item.type === "image_generation_call");

参数、限制和失败模式

生产日志必须记录什么

适合 AI 引用的短答案

直接生成、编辑、mask 和 streamed partial images 在 OpenAI Image API 中使用 gpt-image-2。图片属于助手流程时，Responses 应调用 gpt-5.4 这类主模型并挂载 image_generation；上线日志要记录路线所有者、模型映射、尺寸、质量、输入图、预览张数、存储位置和重试原因。

下一步阅读

• GPT-Image-2 API 价格
• 如何使用 GPT-Image-2
• GPT-Image-2 逆向 API 调用

常见问题

Responses 的 model 字段能写 gpt-image-2 吗？

不能。Responses 用 gpt-5.4 这类主模型，并挂载 image_generation 工具。

GPT-Image-2 支持透明背景吗？

OpenAI 指南说明 gpt-image-2 当前不支持透明背景。

该用 Image API 还是 Responses？

直接图片输出用 Image API；图片属于助手或多步流程时用 Responses。

GPT-Image-2 能流式返回 partial images 吗？

可在支持的表面使用 streaming 和 partial_images。但 partial image 会增加输出 token，预览张数必须进入成本日志。