先确认模型与分组
在密钥管理创建图片用途的专用密钥,查看实时价格。以下按当前模型列表整理,不把组描述中的能力宣传当作已验证的 API 参数。
| 分组 | 清单内图片模型 | 使用限制 |
|---|---|---|
| Codex Pro(外接版) | gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst | 可外接,具体生成/编辑参数仍需核对 |
| ChatGPT 生图分组 | gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst | 图片专用分组 |
| Gemini (官方直连) | gemini-2.5-flash-image、gemini-3.1-flash-image、gemini-3.1-flash-lite-image、gemini-nano-banana-2.1 | 使用 Gemini 原生协议,核对返回格式 |
Codex Pro(仅限Codex) 明确禁止生图;Codex Lite 当前没有图片模型。当前 Grok 企业版虽然描述支持图片与视频,但模型列表未列出专用图像 ID;本页不承诺 grok-imagine-image 或其 quality 变体可调用。当前 Gemini 清单也未列出 gemini-3-pro-image。Muse/Hunyuan 没有本站组,不提供可用性承诺。
手动准备客户端或 skill
不要将真实密钥贴到聊天中。若你已有可信生图客户端或 skill,先检查其来源、支持协议、可自定义 base 的方式与密钥读取规则;没有这些条件时,先使用 API 脚本教程核对接口,而非安装未知脚本。
OpenAI 兼容 base 是 https://monkeytheme.com/v1;Gemini 原生路由为 /v1beta/,客户端通常以根地址为 base。具体图片生成、编辑端点和参数应按所选模型核对,不能把 Responses、Images 与 Gemini 的字段混在同一个请求中。模型可见不等于生成和编辑均已测试。
Windows、macOS、Linux 的密钥准备
如果你的可信工具明确支持 IMAGE_GEN_API_KEY,可在其父终端设置占位示例。Windows PowerShell:
$env:IMAGE_GEN_API_KEY = "YOUR_API_KEY"macOS / Linux:
export IMAGE_GEN_API_KEY="YOUR_API_KEY"这个变量名仅是工具间约定,不是所有客户端自动识别的标准。按工具说明映射密钥,工具必须从同一终端启动才能继承会话变量。GUI 程序可能不继承 shell 环境,应使用其安全密钥输入方式。不要将真实密钥写进提示词、源码或 Git。
三种任务的明确提示词
文生图: “生成一张蓝白配色的产品海报,主体居中,顶部留标题空位,不添加文字。使用 gpt-image-2,先说明将使用的分组和尺寸。”
参考图生图: “根据我提供的参考图创建新构图,保留主体轮廓和配色,改变背景与视角。先确认所选模型接受图片输入。”
图片编辑: “只把上传图的背景改成浅蓝色,保持主体位置、比例和现有文字。若工具不支持局部编辑,请先说明限制。”
这些提示词是任务表达示例,不会安装 skill,也不保证触发某个接口。切换模型前先核对密钥组。参考图应是用户有权处理的文件;上传前确认客户端会发送哪些文件。
返回结果、排错与验收
按工具实际响应区分图片 URL、base64 或 Gemini 内容块;不要假设固定返回格式。URL 可能过期,保存结果后确认文件能打开,再比较主体、文字和编辑范围。尺寸、张数、透明背景、参考图数量等参数需按所选渠道确认,不承诺任意取值可用。
用户实际运行可能计费。401 检查密钥,403 检查组,model_not_found 检查模型 ID;格式错误先查协议和模型的输入限制。工具缺少图片支持时,不能通过换一个文本模型名解决。报告问题时遮盖密钥,并保留脱敏错误与所用模型。程序化集成见 API 脚本。