GPT Image 2 API generate 和 edit 怎么选
编辑部 发布 2026-09-01 最后更新 2026-09-01
mode=generate 用于按提示词生成，mode=edit 用于参考图编辑；两者都调用 POST /images/generations，edit 还须提供公开 HTTPS 的 image_urls。
GPT Image 2 API 的 mode 决定这次请求是生成还是编辑。两种模式都使用 POST /images/generations，不需要更换端点。
两种模式对照
| 模式 | 适用任务 | 额外输入 |
|---|---|---|
generate | 从提示词生成图像 | 不要求参考图 |
edit | 基于输入图修改或参考生成 | 必须传 image_urls |
两者都需要 model=gpt-image-2、prompt、count=1、鉴权头和幂等键。编辑请求的完整写法见API 编辑教程，媒体地址边界见image_urls 要求。
常见选错方式
- 想改已有图片，却使用
generate且没有传参考图； - 使用
edit，但把本地路径或需登录的地址放进image_urls； - 修改了模式和请求体，却仍复用上一份请求的幂等键。
修正请求内容后应使用新的 Idempotency-Key；具体动态规格与积分消耗以官网当前为准。
关于「GPT Image 2 API generate 和 edit 怎么选」的常见问题
- generate 和 edit 使用不同端点吗?
- 不使用。两者都调用 POST /images/generations，通过 mode 和 image_urls 区分。
- edit 可以不传 image_urls 吗?
- 不可以。编辑或参考模式需要公开可访问的 HTTPS 图片地址数组。
- generate 也要传 count 吗?
- 要传，当前公开口径固定为 count=1。