OpenAI Images API quality 参数怎么选择

接口与素材范围

OpenAI Images API quality 参数怎么选择，需要先判断调用的是图片生成接口还是图片编辑接口。资料显示，GPT image models 的生成接口支持 quality 为 auto、low、medium、high；编辑接口支持 auto、low、medium、high，部分旧模型或其他模型的可选值不同。不要把一个模型的参数直接套到另一个模型上。

再写清素材用途：低风险草图、批量构图探索、商品细节展示、正式封面，验收标准并不相同。quality 只负责图像质量档位，不能代替提示词、size、output_format 或人工检查。资料没有确认不同档位必然对应固定处理时间或成本，因此应以实际请求记录为准。

质量档位依据

• auto：第一次接入或任务差异较大时使用，让接口按模型选择质量档位。
• low：适合快速探索构图、批量筛选草案或对细节要求不高的配图。
• medium：适合大多数需要兼顾画面细节与生产效率的商品图、插画和封面初稿。
• high：适合主体细节、材质和局部准确性直接影响交付的正式素材，但是否值得使用要通过固定样本比较。

如果使用 dall-e-3，资料中的可选值是 standard 和 hd；dall-e-2 只有 standard。发送请求前必须根据实际 model 检查允许值。

调用对比流程

1. 记录模型、任务类型、目标尺寸、输出格式和验收标准。
2. 准备一条稳定提示词，只改变 quality，避免同时修改主题、构图和尺寸。
3. 先用 auto 生成一张基准图，再分别用 low、medium 或 high 生成对照样本。
4. 保存每张图片及其请求参数，至少记录 model、quality、size、output_format 和任务编号。
5. 从主体完整度、材质细节、边缘、构图和后期可用性逐项比较，不要只凭缩略图判断。
6. 将通过验收的档位写入对应任务类型的默认配置，其他任务仍保留覆盖参数的能力。

生成结果需要长期保存时，应及时把返回的 Base64 数据写入自己的存储，并同步保存请求参数。可以参考OpenAI Images API 生成结果 URL 和 Base64 怎么保存了解归档思路。

商品图参数示例

假设要生成一款白色保温杯的电商场景图，固定以下提示词和尺寸，只替换 quality：

from openai import OpenAI

client = OpenAI()

result = client.images.generate(
    model="gpt-image-1",
    prompt="白色保温杯放在浅色木质桌面上，正面三分之二视角，柔和自然光，主体完整，背景简洁，保留右侧留白，不出现文字和标识",
    quality="medium",
    size="1024x1024",
    output_format="png",
)

先用 auto、low、medium、high 分别生成对照图。记录每次请求是否成功、返回图片是否完整，以及杯体轮廓、反光、杯盖连接处和阴影是否满足使用要求。若 high 的细节改善无法抵消等待或返工成本，就不要仅因为档位更高而采用它。

故障排查

• 请求提示 quality 无效：原因通常是当前模型不支持该值，或把 GPT image models 的值用于 dall-e-2、dall-e-3。修正动作是先核对 model，再按接口允许值设置；dall-e-2 使用 standard，dall-e-3 使用 standard 或 hd。
• 改成 high 但画面仍不符合要求：原因可能是提示词没有说明主体、视角、留白或限制条件。修正动作是先固定质量档位，补充可验收的画面描述，不要用 quality 代替构图要求。
• 生成结果无法判断哪组更好：原因是每次测试同时改变了多个参数。修正动作是固定 prompt、model、size 和 output_format，只比较 quality，并给样本编号。
• 返回内容无法长期使用：原因是只保存了响应中的临时地址或图片数据，没有建立归档记录。修正动作是生成完成后立即保存图片，并记录 quality 等请求参数。
• 编辑接口参数照搬生成接口：原因是 generate 和 edit 的参数集合并不完全相同。修正动作是根据实际方法检查 quality 的允许值，同时确认输入图片、遮罩和模型限制。

发布验收

• 确认使用的是正确的 Images API 方法：generate 或 edit。
• 确认 model 与 quality 的组合在当前 SDK 类型定义中有效。
• 确认已记录 prompt、model、quality、size、output_format 和任务编号。
• 确认图片尺寸符合投放位置，主体没有被截断，留白满足排版需要。
• 确认商品外形、颜色、材质、边缘和关键细节通过人工检查。
• 确认输出文件已经保存到自己的存储，而不是只保留临时返回地址。
• 确认图片格式、透明背景和压缩设置符合后续使用要求。
• 确认质量对比样本已经筛选，最终档位有明确的任务用途，不是默认追求最高档。