Skip to content
AI Blog

GPT Image API 与 Platform 入门

最后更新：2026-09-09· 17 分钟阅读

🚀 快速通道

  • GPT Image 2 国内版：点击直达↗
  • 文生图工作台：打开镜像↗
  • 官方 ChatGPT：chatgpt.com ↗

GPT Image API 与 Platform 入门

更新时间：2026-08-21。端点、模型 ID、配额与价格以 Images 文档、API 参考 与 定价页 当日内容为准；下文不写死易过期单价、限流数字与请求字段枚举。

导读

「GPT Image API」「gpt-image-2 API」对应的是把图像生成接到网站、设计流水线或内部工具。可上线的接入不只是「跑通一次生成」，还要管：密钥不进前端、模型 ID 可配置、失败可重试、用量可观测、输出可审核。 网页 ChatGPT 适合探索；产品集成走 OpenAI Platform，并先在文档里核对你要用的是 Images API 还是 Responses 里的图像能力。型号产品叙事见 GPT Image 2 指南 与 家族解析。

这篇解决什么问题？

  • 分清 ChatGPT App 体验与 Platform API 两条路径
  • 正确对待产品名（GPT Image 2 / 1.5 等）与文档中的模型 ID
  • 理解 Images API 与 Responses 图像工具的分工，避免抄过期参数
  • 建立密钥、日志脱敏与成本告警的最低安全基线
  • 上线前用检查清单验收，而不是只看一张样图

App ≠ Platform API

路径适合做什么不适合做什么
ChatGPT App快速试构图、对话改图、人工验收高并发生产、密钥托管、稳定 SLA
OpenAI Platform服务端自动化、产品功能、用量计量在浏览器暴露长期 Key
第三方网页入口国内便捷试用（非官方）默认当作官方计费与合规等价物

国内用户若先走第三方网页入口，请记住：第三方 ≠ OpenAI 官方，账号与账单体系可能完全分离。访问路径见 国内使用完全指南。

Images API 与 Responses 图像工具：先选对入口

OpenAI 侧常见两类集成方式（名称与能力边界以文档当日为准）：

  1. Images API（图像专用接口族）
    面向「文生图 / 编辑 /（部分型号的）变体」等图像流水线。适合明确的出图任务、队列化作业、把提示与尺寸档位写进任务元数据。站内开发向说明见 Image Generation。

  2. Responses（或对话式接口）里的图像能力 / 工具
    适合「模型先推理再决定是否出图」、多步工具调用、与文本回复混排的产品形态。参数名、工具开关、输出解析路径可能与纯 Images 调用不同。

不要从旧博客或过期 SDK 示例里抄死 size / quality / tool 字段名当永久真理；发版前用官方文档与控制台「可用模型」列表核对。教程只固定工程原则：服务端调用、可配置模型 ID、分类错误处理、输出转存与审核。

模型 ID：产品名与文档名不要混用

对外沟通可用 GPT Image 2、GPT Image 1.5 等产品称呼；写进代码时，以文档列出的 model id 为准。列表会更新，禁止把某一天的字符串写死在多处业务代码里。

选型速记（细节见专题文）：

Images 2.5 API 双档（Flare / Sunburst）

2026-09 起，OpenAI 在 API 侧将 2.5 拆为两档（产品网页侧多为 ChatGPT Images 2.5）：Flare 偏默认吞吐与延迟；Sunburst 偏精密多轮编辑、更慢。写入配置时从文档复制完整 model id，并保留回退到 gpt-image-2 的开关。选型与工作流见 2.5 指南。

配置建议：模型名放环境变量或远程配置，发版不必改代码。提示词版本号与风格卡 ID 一并记录，方法见 提示词指南。

推荐落地顺序

  1. 在 ChatGPT 或文档示例环境用同一提示跑通目标型号，保存成功参数。
  2. 阅读官方图像文档：鉴权方式、响应里如何取图像（URL / base64 等）、安全过滤说明。
  3. 明确走 Images API 还是 Responses 图像工具；在服务端用官方 SDK 或 HTTPS 调用。
  4. 本地用环境变量注入 Key；为「生成成功 / 安全拦截 / 超时 / 配额」分类打日志（禁止记录完整 Key）。
  5. 生成结果立即转存自有对象存储；临时链接勿当永久 CDN。
  6. 加预算告警与每用户速率限制，避免提示词被刷爆账单。
# 本地开发示例（名称以你项目约定为准）
export OPENAI_API_KEY="your-secret-here"
export GPT_IMAGE_MODEL="/* 从文档复制当日 model id */"
$env:OPENAI_API_KEY = "your-secret-here"
$env:GPT_IMAGE_MODEL = "/* 从文档复制当日 model id */"

硬性规则： Key 只出现在服务端密钥系统；不要写进前端包、Git、截图或共享表格。泄露后立即在 API keys 轮换。

成本与质量可观测

记录每次调用的：模型 ID、分辨率/质量档位、是否带参考图、走的是 Images 还是 Responses 路径、延迟、是否被安全策略拦截、人工是否采用。
这样你才能回答「草稿档节省了多少」「成稿通过率多少」，而不是凭感觉选型。

自动化流水线常见模式：低成本档批量出候选 → 人工或规则初筛 → 主力型号精修 → 设计工具叠字与导出。入门操作见 新手入门；风格分流见 风格与场景实战。

价格与配额以 openai.com/api/pricing 与控制台当日数据为准，本教程不复制易过期数字。

完成检查清单

  • 已确认使用的是文档中的当前模型 ID（可配置）
  • 已明确 Images API 与 Responses 图像工具的选型，未抄过期字段
  • API Key 仅存服务端，仓库无密钥
  • 超时、重试、错误分类已实现
  • 日志无 Key、无未脱敏用户图
  • 用量/预算告警已打开（若控制台提供）
  • 输出有人工或自动审核闸门再对终端用户展示
  • 生成图已转存自有存储，并保留提示与参考图授权记录

快速通道 / 访问入口

常见问题

网页里能选的模型，API 一定有吗？

不一定同步。以 API 文档与控制台「可用模型」列表为准；不要假设 ChatGPT 按钮名等于可调用 ID。

可以在浏览器直连 OpenAI API 出图吗？

不推荐。浏览器无法安全持有长期 Key，且容易被盗刷。应通过自有后端代理。

Images API 和 Responses 出图可以混用同一套参数吗？

不要假设字段一一对应。以你选定路径的当日文档为准分别实现；共享的是提示词版本与业务元数据，而不是抄同一份过期 JSON。

第三方国内站的「API」能当官方用吗？

不能默认等价。协议、日志、模型路由与合规责任都可能不同；正式产品集成优先官方 Platform 路径，并单独评估第三方条款。

价格和 RPM 限流写在哪？

以 OpenAI 定价与配额页面的当日数据为准；本教程不复制易过期数字。

官方资源

延伸阅读

总结

GPT Image 的工程接入，关键是把探索（ChatGPT App）与生产（Platform 服务端）分开：先选对 Images API 或 Responses 图像路径，模型 ID 可配置、密钥不出前端、成本与拦截可观测、输出经审核再上线。先读官方图像文档核对当日型号与字段，再把提示词与风格卡版本化，流水线才能既快又可控。

相关内容