使用指南

GPT Image API 指南：模型 ID、路由与迁移

一份长期有效的地图：从旧的 OpenAI 图像名称到 GPT Image 2，涵盖当前的 HiAPI 模型 ID、已退役的 Pro 替代方案，以及每个下一步该看哪一页。

2026年11月3日

简短回答

对于新的 OpenAI 直连图像集成，当前模型 ID 是 gpt-image-2。对于新的 HiAPI 集成，如果任务从提示词开始，请使用 gpt-image-2/text-to-image；如果任务从一张或多张参考图开始，请使用 gpt-image-2/image-to-image。

这些名称很容易混淆，因为人们会用“GPT-4o image”“ChatGPT image generation”“GPT Image API”和“GPT Image 2”来指代相关但不同的产品界面。稳妥的做法是先确认你要调用的是哪个 API，然后使用该 API 对应的模型 ID 和请求契约。

界面	当前模型或选择器	请求模式
OpenAI Image API	`gpt-image-2`	OpenAI `/v1/images/generations` 或 `/v1/images/edits`
OpenAI Responses API	受支持的主线模型加上图像生成工具	通过 `/v1/responses` 进行对话式或多步图像工作
HiAPI 文生图	`gpt-image-2/text-to-image`	`POST https://api.hiapi.ai/v1/tasks`
HiAPI 图生图	`gpt-image-2/image-to-image`	`POST https://api.hiapi.ai/v1/tasks`

HiAPI 不会代理 OpenAI Image API 的请求体。它通过统一的异步任务契约来提供 GPT Image 路由，因此只改主机名并不算完成迁移。

开发者需要了解的 GPT Image 谱系

有用的谱系是一张可操作的迁移地图。下面的名称并非都指向可互换的 API 模型。

你可能在旧代码或搜索结果中看到的名称	当前状态	现在该怎么做
“GPT-4o image generation”或“ChatGPT image generation”	产品界面或 UI 措辞，不是可以粘贴到新图像请求中的当前图像模型 ID	先选择一个 API 界面，然后使用其当前模型和请求契约
`chatgpt-4o-latest`	已弃用的 ChatGPT 模型别名；OpenAI 当前模型页面列出的是图像输入，而非图像输出	不要将其用作图像生成的迁移目标
`gpt-image-1`	OpenAI 将其标注为上一代、已弃用的图像生成模型	将新的图像工作迁移到 `gpt-image-2`
`gpt-image-1.5`	OpenAI 将其标注为上一代、已弃用的图像生成模型	将新的图像工作迁移到 `gpt-image-2`
`dall-e-2` 或 `dall-e-3`	已弃用并从 OpenAI API 中移除	OpenAI 建议当前生成和编辑使用 `gpt-image-2`
`gpt-image-2`	OpenAI 当前的直连图像模型 ID	与 OpenAI Image API 一起使用，或将任务映射到下方的 HiAPI 斜杠 ID

OpenAI 当前文档将 gpt-image-2 描述为其最先进的图像生成模型，并记录了文生图生成和图像编辑。 OpenAI 图像生成指南还将一次性 Image API 与通过 Responses API 进行的对话式图像生成区分开来。上述模型状态说明来自以下官方页面： GPT Image 2、 GPT Image 1.5、 GPT Image 1、 DALL-E 2、 DALL-E 3 和 ChatGPT-4o，核查日期为 2026 年 8 月 31 日。

从 UI 工作流转向 API 工作流

ChatGPT 图像会话将模型选择、状态、重试和文件处理隐藏在对话背后。API 集成必须显式做出这些决策。

OpenAI 官方指南建议，单次生成或编辑使用其 Image API，对话式、多轮图像工作使用 Responses API。HiAPI 使用第三种契约：每个图像任务都是一个异步任务。你的后端提交任务、存储返回的 taskId，并通过回调或稍后的任务详情请求接收最终结果。

来自 UI 会话的创意简报仍然是有用的起始提示词，但要将其移入 API 实际的请求 schema，并测试输出。不要把 UI 产品名称复制到 model 字段中，并假设它是稳定的 API ID。

对于 HiAPI，请将 API key 保留在服务器上，并像这样提交任务：

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2/text-to-image",
    "input": {
      "prompt": "A clean launch poster with the exact headline SUMMER DROP",
      "aspect_ratio": "4:5",
      "resolution": "1K"
    },
    "callback": {
      "url": "https://your-domain.com/hiapi/callback",
      "when": "final"
    }
  }'

callback 对象应位于顶层，与 model 和 input 并列。对于本地调试或对账，请轮询 GET https://api.hiapi.ai/v1/tasks/{taskId}。任务成功后，请从 data.output[].url 下载图像，而不要把临时输出 URL 当作永久存储。

本中心页特意只展示一个请求。路由特定字段、回调、轮询和可复制粘贴的示例，请参阅文生图 API 文档或图生图 API 文档。

将旧 OpenAI 图像调用迁移到 HiAPI

OpenAI 模型迁移和提供商契约迁移是两项独立的变更。首先选择当前的图像任务，然后为 HiAPI 的任务 API 重写请求。

旧输入	当前 OpenAI 直连目标	当前 HiAPI 目标
使用 `gpt-image-1`、`gpt-image-1.5` 或 DALL-E ID 进行文生图	`gpt-image-2` 生成	`gpt-image-2/text-to-image`
使用 `gpt-image-1` 或 `gpt-image-1.5` 进行图像编辑	`gpt-image-2` 编辑	`gpt-image-2/image-to-image`
仅 UI 的 ChatGPT 或 GPT-4o 图像工作流	根据交互设计选择 OpenAI Image API 或 Responses API	选择 HiAPI 文生图或图生图任务路由

迁移到 HiAPI 时，请用 taskId 持久化、终态处理和输出下载来替换同步或 OpenAI 特有的响应处理。请重新验证提示词和输出，不要承诺跨界面结果像素级一致。

迁移旧的 HiAPI 模型名称

HiAPI 现在使用任务特定的斜杠 ID 和顶层路由选择器。新代码应使用下方的规范请求形态。

旧 HiAPI 名称	当前请求
`gpt-image-2`	`model: "gpt-image-2/text-to-image"`
`gpt-image-2-image-to-image`	`model: "gpt-image-2/image-to-image"`
`gpt-image-2-beta`	`model: "gpt-image-2/text-to-image"` 加上 `route: "beta"`
`gpt-image-2-ext`	`model: "gpt-image-2/text-to-image"` 加上 `route: "ext"`
`gpt-image-2-i2i-ext`	`model: "gpt-image-2/image-to-image"` 加上 `route: "ext"`

公开定价数据可能将带路由的条目写作 gpt-image-2/text-to-image@ext 或 gpt-image-2/image-to-image@ext。HiAPI 也接受带路由限定的形式，但模型文档使用基础斜杠 ID 加上顶层 route 字段，因为这样更容易看清路由特定的输入 schema。

替换已退役的 HiAPI Pro ID

HiAPI 已于 2026 年 7 月 2 日退役两个旧的 Pro ID。它们不再出现在当前公开定价数据中，也不应保留在新示例里。

已退役 ID	替代方案
`gpt-image-2-pro`	`gpt-image-2/text-to-image`
`gpt-image-2-image-to-image-pro`	`gpt-image-2/image-to-image`

本次模型迁移并不保证旧 Pro 的每个参数都能产生完全相同的效果。请查看对应模型文档中的当前路由 schema，然后在生产切换前运行一个有代表性的提示词和参考图测试。

下一步该看哪里

本页用于名称、谱系和迁移。请根据你要回答的问题选择对应目的地：

开始与集成

GPT Image 2 模型页面了解当前模型和 Playground。
GPT Image 2 图生图模型页面了解 Playground 中的参考图编辑。
GPT Image 2 文生图文档了解 standard、beta 和 ext 请求字段。
GPT Image 2 图生图文档了解 standard 和 ext 编辑字段，包括参考图命名差异。
GPT Image 2 API 定价了解当前路由表、参考图附加项和预算计算。
HiAPI 实时定价了解完整的当前模型目录。

用例与实测证据

对比与选型

常见问题

当前 GPT Image API 模型 ID 是什么？

对于 OpenAI 的直连 Image API，是 gpt-image-2。对于 HiAPI，请根据任务是从文本还是参考图开始，使用 gpt-image-2/text-to-image 或 gpt-image-2/image-to-image。

我可以把裸模型名 `gpt-image-2` 发送给 HiAPI 吗？

不要在新的 HiAPI 代码中使用裸名称。当前规范 ID 是上方展示的任务特定斜杠名称，它们也使定价、schema 和模型页面路由更加明确。

HiAPI 使用 OpenAI 的 `/v1/images/generations` 端点吗？

不。HiAPI 图像模型使用 POST /v1/tasks，随后通过最终回调或 GET /v1/tasks/{taskId} 获取结果。OpenAI Image API 和 HiAPI 任务 API 的请求与响应契约不同。

回调应该放在哪里？

将 callback 放在任务体顶层，与 model 和 input 并列。使用 callback.when: "final"，并让接收服务按 taskId 保持幂等，因为成功和失败都是终态结果。

什么替代 `gpt-image-2-pro`？

使用 gpt-image-2/text-to-image。对于已退役的图生图 Pro ID，使用 gpt-image-2/image-to-image。切换前请查看当前输入 schema，并测试有代表性的任务。

标签Image API Migration

查看全部文章 →