文档目录
首页 / 开发文档 / GPT Image 2.5 / 2 生图指南
使用帮助

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。下面示例均为占位符。

API Key 等同于账户调用凭证。请从控制台复制真实 Key,并只写入本机 Skill 配置;不要提交到公开仓库,也不要出现在群聊、录屏或截图中。

选择 GPT Image 2.5 或 GPT Image 2

GPT Image 2.5 包含 Flare 与 Sunburst。OpenAI 官方指南将 Flare 定位于快速日常生成,将 Sunburst 定位于更精细的编辑工作流;这些定位不构成本站速度或效果承诺。请以当前 Key 的模型清单与权限为准。

模型API model 参数选择参考
GPT Image 2.5 Flaregpt-image-2.5-flare偏向快速、日常图像生成
GPT Image 2.5 Sunburstgpt-image-2.5-sunburst偏向精细图像编辑
GPT Image 2gpt-image-2保留原有工作流时按需选择
OpenAI 官方图像生成指南查看 GPT Image 2.5 Flare / Sunburst 的官方模型选择说明;本站支持范围以对应分组为准。
  • 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 的说明完成安装。

不同 Skill 使用的环境变量和配置文件可能不同,请以所选仓库的最新说明为准;不要自行把 /images/generations 等接口路径拼接到 Base URL 后面。
  1. 复制下面的安装指令

    示例选择 gpt-image-2-skill;如需使用另一个 Skill,只替换仓库地址和 Skill 名称。

  2. 替换本机 API Key

    将 sk-your-api-key 替换为 dacall.AI 控制台创建的真实 Key,并确保 Agent 不把它写入项目仓库。

  3. 核对实际配置

    安装结束后,让 Agent 复述已配置的接口地址、模型名和配置文件位置;Key 只显示脱敏结果。

  4. 重启 Agent

    如果新 Skill 没有立刻出现在可用列表中,完全退出并重新打开 Claude Code、Codex 或当前使用的 Agent。

发送给 AI 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。

使用参考图进行编辑

把参考图放在当前工作区或提供可读取的本地路径,再说明需要保留和修改的部分。涉及品牌资产时,建议明确要求保持标志形状、比例和安全留白。

Skill 名称以实际安装结果为准。显式写出 Skill 名称,可以减少 Agent 误选其他生图工具的情况。
参考图编辑示例
使用 gpt-image-2-skill 参考当前目录的 logo.png,保持标志形状和比例不变,生成适合深色背景使用的版本,保存为 logo-dark.png。

常见问题排查

联系支持时请提供发生时间、模型名、错误信息和 Request ID;API Key 必须脱敏,图片中如有隐私内容也请先处理。
问题处理方式
认证失败核对 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 权限和图片展示配置。