开发者资源
GPT Image 2 API 指南
如果你正在评估什么时候应该直接用网页工作台，什么时候应该深入到 API 侧，这一页会帮助你用更工程化的方式做判断。
先判断：你真的需要 API 吗？
如果你的目标只是快速写 prompt、切换比例、比较 1K 与更高分辨率的结果，并人工下载或继续编辑，那么网页工作台通常已经足够。它的价值在于摩擦更低、验证更快，也更适合第一次梳理视觉方向。
但如果你已经明确需要批量化、自动化、模板化，或者要把图像生成嵌进自己的产品、脚本和后台系统里，API 的价值就会明显上升。此时你需要关注的，不再只是 prompt 写法，而是参数兼容性、速率限制、错误恢复和成本结构。
批量电商视觉
把同一商品的不同卖点文案组合进提示词，在固定比例和分辨率下批量生成主图、广告图和详情页素材。
工作流自动化
将图像生成嵌入内部内容系统、运营后台或自动化脚本，让文本、参考图和输出逻辑进入统一流水线。
应用内创意功能
如果你要让用户在自己的产品里直接生成海报、封面、角色图或营销素材，API 会比人工操作网页更稳定。
接入前必须核对的参数与约束
对于 GPT Image 2 这类图像接口，最容易被忽略的不是鉴权，而是参数之间的兼容关系。比例、分辨率、文生图与图生图模式，看起来只是几个表单选项，但一旦在生产环境里组合错误，就会带来失败任务、无意义重试和额外成本。
在当前工作台里，我们已经把一些真实约束前置到交互层，例如 auto 比例只能走 1K，1:1 不能直接选择 4K。对开发者来说，这类规则最好在请求发出前就校验，而不是把所有错误都留给模型侧返回。
实现时建议记录的状态
- 用户登录态与购买状态分开判断，不要把“存在 customer 记录”直接当成已付费。
- 记录任务发起时间、任务 ID、模式、比例和分辨率，方便排查失败任务。
- 把超时和失败分开处理，不要把所有错误都折叠成一个笼统的 500。
开发文档最该写清楚的部分
- 哪些比例和分辨率组合可用，哪些组合会失败。
- 免费与付费用户的权限边界，例如 1K 与 2K/4K 的解锁逻辑。
- 失败时是否自动退还额度、重试策略如何定义，以及前端如何给出明确反馈。
