GPT-image-2 生图
GPT-image-2 是 OpenAI 的图像生成模型,支持文生图和图生图(编辑、参考图)。通过安装生图 skill,你可以让 Claude Code、Codex 等 AI agent 直接调用 yylx.io 的接口生成图片,无需自己写调用代码。
[!TIP] 使用前请先在控制台确认你的 API Key 支持 GPT-image-2 相关模型。文档中的示例会用
sk-your-api-key代替真实 Key。
可选的 Skill
社区中当前有很多 GPT-image-2 的相关 skill,比如:
| Skill | 地址 | 特点 |
|---|---|---|
| GPT-Image2-Skill | https://github.com/wuyoscar/GPT-Image2-Skill | 附带精选提示词库,支持 Claude Code 插件市场安装 |
| gpt-image-2-skill | https://github.com/wangnov/gpt-image-2-skill | Rust 实现,支持透明 PNG 提取、本地历史记录,输出对 agent 友好 |
安装方式
不需要手动执行安装命令,直接把安装和配置需求告诉 AI agent 即可。在 Claude Code(或其他支持 skill 的 agent)中发送:
帮我安装一下这个 skill,地址是 https://github.com/wangnov/gpt-image-2-skill
并且帮我配置好,自定义 Host 为 https://app.yylx.io,API_KEY 为 sk-your-api-key
如果你选择另一个 skill,把地址换成 https://github.com/wuyoscar/GPT-Image2-Skill 即可。
AI agent 会自动完成下载安装,并把 Host 和 API Key 写入对应的配置位置。安装完成后,可以让它复述一遍当前配置,确认 Host 与 Key 已正确生效。
[!WARNING] API Key 请从控制台「API 密钥」页面复制真实的 Key 替换
sk-your-api-key。不要把 Key 粘贴到公开仓库、群聊或截图中。
开始生图
安装配置完成后,用自然语言让 AI agent 生图即可。建议在指令中明确写出 skill 名称,让 agent 准确调用对应的 skill,例如:
使用 gpt-image-2-skill 帮我生成一张红苹果的工作室产品照,透明背景,保存为 apple.png
也可以提供参考图进行编辑:
使用 gpt-image-2-skill 参考这张 logo.png,帮我改成深色背景版本
skill 名称以你实际安装的为准,例如安装的是 GPT-Image2-Skill,就在指令中写它的名称。多数 agent 在描述与生图相关时也能自动选中 skill,但显式指定更稳妥。
生成的图片会保存到当前目录或你指定的路径。
常见排查
| 问题 | 处理方式 |
|---|---|
| 认证失败 | 确认配置中的 API Key 与控制台一致,且 Key 处于可用状态 |
| 连接失败 | 确认 Host 填写为 https://app.yylx.io,不要自行拼接接口路径 |
| 模型不可用 | 到控制台核对当前分组是否支持 GPT-image-2 相关模型 |
| 429 限流 | 短时间内生图请求过多,稍后重试或降低并发 |
| skill 未生效 | 重启 AI agent(如重新打开 Claude Code),让新安装的 skill 加载 |
遇到接口报错时,可以对照常见错误进一步排查。