Leonardo 调整图像参数:GPT Image-1.5 与 Ideogram 3.0 改用 quality
Leonardo.Ai 调整平台图像模型的参数命名:GPT Image-1.5 与 Ideogram 3.0 生成请求里的 mode 参数已按公告在 2026 年 5 月 4 日停用,需要改用 quality。官方同时给出两个模型各自可用的取值,并说明除参数名外不用改其他请求结构。
Leonardo 将两个图像模型的 mode 参数换成 quality
Leonardo.Ai 把 GPT Image-1.5 与 Ideogram 3.0 的 mode 参数换成 quality。 按公告,2026 年 5 月 4 日之后仍带 mode 的请求会失败。
受影响的两个模型
官方在表格里点名两个图像模型:GPT Image-1.5 与 Ideogram 3.0。两者都是 Leonardo 平台上可调用的第三方图像模型,改动落在参数名上。
新旧取值怎么对应
- GPT Image-1.5 的新取值是 LOW、MEDIUM、HIGH。
- Ideogram 3.0 的新取值是 TURBO、BALANCED、QUALITY。
- 官方示例把原来的 mode=QUALITY 改写成 quality=HIGH。
官方给的最小改动
官方原文称:“The mode parameter for GPT Image-1.5 and Ideogram 3.0 generations is being retired on May 4, 2026. Use the quality parameter instead.”
迁移只动一个字段,官方明确写着其余请求不需要改。(来源:Leonardo.Ai 官方文档)
仍传 mode 的集成会报错,只需改字段名
已经在 Leonardo API 上跑图像生成的集成需要改参数名,否则请求会直接报错。 业务侧的出图流程本身不用重做。
对现有管线
只要请求体里出现 mode,生成就会失败。把字段换成 quality、并按模型填对应的枚举值即可,提示词、尺寸与图片数量都不受影响。
对画质与成本
官方没有说明新旧档位之间是否一一等价,也没给出价格差异。从官方描述看,这次只是命名变更,画质表现需要自己用同一提示词对比确认。
停用日期已过,先全局搜索 mode 再灰度验证
从实际使用角度看,已经过了公告的停用日期,仍在使用 mode 的集成应尽快改完。判断条件是请求里是否还有 mode 字段。
检查清单
- 全局搜索代码与配置里的
mode,确认是否落在图像生成请求体里。 - 按模型替换取值:GPT Image-1.5 用 LOW、MEDIUM、HIGH,Ideogram 3.0 用 TURBO、BALANCED、QUALITY。
- 用一条灰度请求验证返回正常,再合并到主分支。
顺带关注模型本身
如果你也在评估 Ideogram 的新版本,可以看 Ideogram 4.0 开放权重版本说明。
常见问题
- Leonardo 为什么停用 mode 参数?
- 官方公告给出的做法是把 mode 换成 quality,但没有说明停用背后的产品原因。
- GPT Image-1.5 的 quality 有哪些取值?
- 官方列出 LOW、MEDIUM、HIGH 三档。
- Ideogram 3.0 的 quality 有哪些取值?
- 官方列出 TURBO、BALANCED、QUALITY 三档。
相关术语
- mode 参数
- mode 是 Leonardo API 里控制生成档位的旧参数名,现已由 quality 取代。
- quality 参数
- quality 是新的生成档位参数,取值随模型不同而不同。
- 请求结构
- 请求结构指调用生成接口时 JSON 里的字段层级与字段名。
这篇文章的来源是什么?
文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。
- Deprecations & Changes · Leonardo.Ai · 2026-11-18
「Deprecations & Changes」 —— Leonardo.Ai
文章目录