GPT Image 2.5 / 2 生图指南
GPT Image 2.5 提供 Flare 与 Sunburst 两种选择,覆盖图像生成和参考图编辑。本指南介绍模型选择,以及通过 Claude Code、Codex 等 AI Agent 接入 dacall.AI 生图服务的方法。
开始前检查
登录 dacall.AI 控制台,确认当前 API Key 所属分组可用的完整模型名称,并准备一个专用于本机 Agent 的 Key。GPT Image 2.5 需要指定 Flare 或 Sunburst,不能仅填写 gpt-image-2.5。下面示例均为占位符。
选择 GPT Image 2.5 或 GPT Image 2
GPT Image 2.5 包含 Flare 与 Sunburst。OpenAI 官方指南将 Flare 定位于快速日常生成,将 Sunburst 定位于更精细的编辑工作流;这些定位不构成本站速度或效果承诺。请以当前 Key 的模型清单与权限为准。
| 模型 | API model 参数 | 选择参考 |
|---|---|---|
| GPT Image 2.5 Flare | gpt-image-2.5-flare | 偏向快速、日常图像生成 |
| GPT Image 2.5 Sunburst | gpt-image-2.5-sunburst | 偏向精细图像编辑 |
| GPT Image 2 | gpt-image-2 | 保留原有工作流时按需选择 |
- Skill 名称不等于模型名称。安装的 gpt-image-2-skill 名称可以不变,但需确认所用版本允许配置完整的 2.5 模型 ID。
- 本页安装示例使用 gpt-image-2.5-flare;如需 Sunburst,替换完整模型 ID,并先确认该 Key 有相应权限。
- 旧 GPT Image 2 工作流可继续使用 gpt-image-2;不要仅通过模型名称推断特定接口或参数全部可用。
选择生图 Skill
下面两个开源 Skill 原有 GPT Image 2 接入说明可供参考。使用 2.5 时,先确认所安装版本支持自定义模型参数及对应接口;仓库或 Skill 名称含“2”并不代表已配置为 2.5。选择其一即可。
GPT-Image2-Skill包含提示词资源,并提供面向 Claude Code 的安装方式。gpt-image-2-skillRust 实现,支持透明 PNG 处理、本地历史记录和 Agent 友好的输出。让 AI Agent 完成安装和配置
不必手动寻找配置文件。把 Skill 仓库地址、dacall.AI 接口地址和 Key 占位符一起交给 AI Agent,让它按所选 Skill 的说明完成安装。
- 复制下面的安装指令
示例选择 gpt-image-2-skill;如需使用另一个 Skill,只替换仓库地址和 Skill 名称。
- 替换本机 API Key
将 sk-your-api-key 替换为 dacall.AI 控制台创建的真实 Key,并确保 Agent 不把它写入项目仓库。
- 核对实际配置
安装结束后,让 Agent 复述已配置的接口地址、模型名和配置文件位置;Key 只显示脱敏结果。
- 重启 Agent
如果新 Skill 没有立刻出现在可用列表中,完全退出并重新打开 Claude Code、Codex 或当前使用的 Agent。
请帮我安装这个生图 Skill:
https://github.com/wangnov/gpt-image-2-skill
安装后请按仓库说明配置为:
- OpenAI 兼容接口地址:https://api.dacall.ai/v1
- API Key:sk-your-api-key
- 模型:gpt-image-2.5-flare
- 先确认所安装版本支持此完整模型 ID;不支持时请说明,不要静默改用其他模型。
请把凭证只保存在本机 Skill 要求的安全配置位置,不要写入当前项目或任何公开文件。完成后请复述配置文件位置,并对 API Key 脱敏。开始文生图
安装成功后,直接用自然语言描述画面,并明确指定刚安装的 Skill。把主体、风格、构图、背景、尺寸和保存文件名写清楚,通常能得到更稳定的结果。
使用 gpt-image-2-skill 生成一张红苹果的工作室产品照:正面视角、柔和侧光、透明背景,保存为 apple.png。使用参考图进行编辑
把参考图放在当前工作区或提供可读取的本地路径,再说明需要保留和修改的部分。涉及品牌资产时,建议明确要求保持标志形状、比例和安全留白。
使用 gpt-image-2-skill 参考当前目录的 logo.png,保持标志形状和比例不变,生成适合深色背景使用的版本,保存为 logo-dark.png。常见问题排查
| 问题 | 处理方式 |
|---|---|
| 认证失败 | 核对 API Key 是否来自 dacall.AI 控制台、是否已启用,以及配置中是否混入空格或换行。 |
| 连接失败 | 确认 OpenAI 兼容接口地址为 https://api.dacall.ai/v1,并检查本机网络与代理设置。 |
| 模型不可用 | 核对当前 Key 分组和完整模型 ID:gpt-image-2.5-flare、gpt-image-2.5-sunburst 或 gpt-image-2;不要填写 gpt-image-2.5,也不要仅凭旧测试判断当前可用性。 |
| 429 或请求过多 | 降低并发并稍后重试;持续出现时,检查账户额度与当前分组限制。 |
| Skill 未加载 | 确认安装目录正确,然后完全退出并重启 AI Agent。 |
| 生成成功但图片不显示 | 先确认文件已写入本地,再按照 Codex 生图不显示帮助页检查 Provider 权限和图片展示配置。 |
dacall