Skip to Content
模型用法GPT Image用你自己的工具生图准备 Key

用你自己的工具生图

不用写代码。在你平时用的工具里接上 GPT Image,就能直接生图。

第 1 步:准备 Key

这一步在做什么: Key 相当于你的账号密码,工具要靠它来调用 OfoxAI。

  1. 打开 OfoxAI 控制台 ,进入 Settings → API Keys,点 Create New Key。
  2. 马上复制下来存好。Key 只在创建时显示一次,关掉就看不到了。

建议专门给这个工具建一个 Key,以后不用了或者担心泄露,单独删掉它就行,不影响别的地方。

大概花多少钱: 按画质计费。按 OpenAI 官方参考价,一张 1024×1024 的图,最低画质不到 1 美分;gpt-image-2 的高画质约 21 美分。先用最低画质试,满意再调高。详见画质与价格。

Key 只填在工具的设置里,或者填进编程助手告诉你的文件里。不要发在聊天对话里,也不要截图发给别人。

下一步: 判断你的工具是哪一类。

第 2 步:判断你的工具是哪一类

这一步在做什么: 不同工具接入方法不一样,先对号入座。

你的工具例子接入方法
聊天、绘图客户端:有界面,可以自己添加模型服务商Cherry Studio、LobeHub 等在设置里填几项配置
AI 助手 / 编程助手:用对话让它帮你写代码、操作电脑Claude Code、Codex、ZCode、OpenClaw、WorkBuddy 等复制一段提示词发给它

常用工具对号入座(2026-09-30 查证):

工具怎么接
Cherry Studio聊天、绘图客户端。添加模型时,把「端点类型」选成「图像生成 (OpenAI)」,模型才会出现在「绘画」里。接入服务商的步骤见 Cherry Studio 配置
LobeHub聊天、绘图客户端,但要用它内置的「OpenAI」服务商。 LobeHub 自己添加的模型不能设成图像类型,所以不要新建服务商:在内置的 OpenAI 服务商里把 API 代理地址改成 https://api.ofox.io/v1、填上 Key,生图时选 GPT Image 2。2.5 两款还不在它的内置列表里
Chatbox暂时不能用。 它的生图功能目前只能走 Chatbox 自己的服务,接不了外部服务商
WorkBuddyAI 助手、编程助手。 它的模型设置只能接对话模型,先按 WorkBuddy 配置 接好,再把下面的提示词发给它
Claude Code、Codex、ZCode、OpenClawAI 助手、编程助手。 直接把下面的提示词发给它

还是分不清的话:设置里有「添加服务商」「自定义 API」这类选项,按聊天、绘图客户端接;平时是让它帮你写代码、做任务,按AI 助手、编程助手接。

下一步: 跳到对应的方法。

聊天、绘图客户端

确认工具能生图

这一步在做什么: 确认你的工具能接外部的生图模型。不是所有工具都行。

需要同时满足两点:

  • 工具里有「绘画」「生图」「图像生成」之类的入口。
  • 这个入口里可以选你自己添加的服务商和模型。

有些工具的绘图功能只能用它自带的模型,选不了你添加的服务商,这类工具接不了 GPT Image。不确定的话查一下工具自己的说明。不满足的话,改按AI 助手、编程助手的方式接。

添加 OfoxAI 服务商

这一步在做什么: 告诉工具去哪里调用、用哪个 Key。

已经在这个工具里接过 OfoxAI 的聊天模型? 直接用那个服务商,跳到下一步。

还没接过? 按工具的配置指南操作,里面有每一步的截图:Cherry Studio · LobeHub · 全部工具。关键的几项是:

添加服务商时填这些
服务商类型OpenAI没有 OpenAI 的话,选「OpenAI 兼容」
API 地址https://api.ofox.io/v1个别工具(如 NextChat)要去掉末尾的 /v1,以该工具的配置指南为准
API Key粘贴第 1 步复制的 Key

用 LobeHub 的话不要新建服务商。 LobeHub 自己添加的模型不能设成图像类型,要改它内置的「OpenAI」服务商:

LobeHub:在内置的 OpenAI 服务商里填
API 代理地址https://api.ofox.io/v1
API Key粘贴第 1 步复制的 Key
生图时选GPT Image 22.5 两款还不在 LobeHub 的内置列表里

添加生图模型

这一步在做什么: 告诉工具用哪个模型生图。

在这个服务商下手动添加模型,复制下面其中一个模型 ID:

添加模型时填这些
模型 IDopenai/gpt-image-2.5-flare日常生图,出图快,推荐先用这个
模型 IDopenai/gpt-image-2.5-sunburst改图,更贴近原图
模型类型图像生成Cherry Studio 里叫「端点类型」,选「图像生成 (OpenAI)」;其他工具选图像生成一类,不要选对话

开始生图

这一步在做什么: 在生图入口里选上刚添加的模型,输入描述,生成一张试试。

如果工具里能选「画质」,先选低(low),确认能出图再调高。画质越高,费用越高、耗时越长,高画质可能需要等待数分钟。

生不出图?看常见问题。

AI 助手、编程助手

还没装编程助手的话,先按教程装好:Claude Code、Codex、OpenClaw。

编程助手能帮你做两件事,按你的需要选一个:

  • 直接帮我生图:你用对话描述想要的图,它生成后保存到电脑上。
  • 接进我正在做的项目:比如你在做一个网站或小程序,想让它有生图功能。

把提示词发给编程助手

这一步在做什么: 告诉编程助手要做什么、怎么做才安全。它会先带你把 Key 存好,再开始干活。

按你的需要,复制其中一段,发给 Claude Code、Codex、ZCode、OpenClaw 或 WorkBuddy:

直接帮我生图

想用对话让它帮你生成图片时,复制这一段。

我想用 OfoxAI 的 GPT Image 模型生成图片。我已经在 OfoxAI 控制台创建好了 API Key。我不太懂技术,请一步步带我做,每一步先用大白话告诉我你在做什么、下一步是什么。

【第一步:帮我安全地保存 Key】
1. 在当前文件夹创建 .env 文件,写入一行 OFOX_API_KEY=,等号后面留空。如果当前文件夹是代码仓库,把 .env 加进 .gitignore。
2. 告诉我这个文件在哪、怎么打开,让我自己把 Key 粘贴到等号后面并保存。
3. 不要让我把 Key 发在对话里。如果我不小心发了,提醒我去控制台删掉这个 Key,换一个新的。
4. 等我告诉你「填好了」再继续。

【第二步:准备生图】
5. 写一个小脚本,从 .env 读取 OFOX_API_KEY,调用 POST https://api.ofox.io/v1/images/generations 生图。
6. 模型用 openai/gpt-image-2.5-flare,quality 用 low,size 用 1024x1024,客户端超时设为 600 秒。
7. 返回的 data[0].b64_json 是纯 base64,解码后保存成 PNG,放在当前文件夹的 images 目录里。
8. 不要把 Key 打印出来,也不要写进脚本里。

【第三步:试一张】
9. 先生成一张「白色桌面上的一个红苹果」,告诉我图片保存在哪、怎么打开。
10. 之后我每次描述一张图,你就用这个脚本生成一张,并告诉我保存位置。想要更清晰时,我会说「画质高一点」,你再把 quality 改成 medium 或 high,并提醒我会更贵、更慢。

【出错时】
11. 打印 HTTP 状态码和完整报错(包括 error.message 和 request_id),对照 https://ofox.io/zh/docs/develop/models/gpt-image#errors 找原因,只改一处再试。
12. 同一个错误改两次还没解决,就停下来,用大白话告诉我出了什么问题,并把 request_id 和报错信息原文给我,方便我联系 OfoxAI。
13. 一次只生成一张,不要自己批量重试(每次请求都会计费)。

接进我正在做的项目

想让你的网站、应用有生图功能时,复制这一段。

我想在当前项目里接入 OfoxAI 的 GPT Image 图像生成。我已经在 OfoxAI 控制台创建好了 API Key。我不太懂技术,请一步步带我做,每一步先用大白话告诉我你在做什么、下一步是什么。

【第一步:帮我安全地保存 Key】
1. 在项目里创建 .env 文件,写入一行 OFOX_API_KEY=,等号后面留空。
2. 把 .env 加进 .gitignore,确保它不会被提交或上传。
3. 告诉我这个文件在哪、怎么打开,让我自己把 Key 粘贴到等号后面并保存。
4. 不要让我把 Key 发在对话里。如果我不小心发了,提醒我去控制台删掉这个 Key,换一个新的。
5. 等我告诉你「填好了」再继续。

【第二步:写代码】
6. 用 OpenAI 官方 SDK 调用 OfoxAI 的图像接口,base_url 为 https://api.ofox.io/v1,Key 从 .env 里的 OFOX_API_KEY 读取。
 - 文生图:POST /v1/images/generations
 - 改图、多图融合、局部重绘:POST /v1/images/edits(multipart 上传)
7. 模型 ID 写全:openai/gpt-image-2.5-flare(改图用 openai/gpt-image-2.5-sunburst)。
8. 显式传 quality,开发阶段用 low。不传时模型会自己选档。
9. size 必须同时满足:宽高都能被 16 整除、最长边 ≤ 3840、宽高比在 1:3 到 3:1 之间、总像素 ≥ 655,360。
10. 结果在 data[0].b64_json,是不带 data: 前缀的纯 base64,解码后保存成图片文件。
11. 客户端超时设为 600 秒。
12. 不要传 response_format、input_fidelity、style。
13. 不要把 Key 写进代码、日志或报错信息;打印请求时把 Authorization 头打码。

【第三步:测试】
14. 用 quality=low、size=1024x1024 真实调用一次,确认返回 200、图片能打开,然后告诉我图片保存在哪。
15. 测试时一次只生成一张,不要写循环批量测试(每次请求都会计费)。

【出错时】
16. 打印 HTTP 状态码和完整响应体(包括 error.message 和 request_id),对照 https://ofox.io/zh/docs/develop/models/gpt-image#errors 找原因。
17. 429 等一会儿再重试;其他错误先改请求,不要原样重试。
18. 同一个错误改两次还没解决,就停下来,用大白话告诉我出了什么问题,并把 request_id 和报错信息原文给我,方便我联系 OfoxAI。

【上线前自查】
19. 我说「准备上线」时,逐条检查并告诉我结果:代码和提交记录里没有 Key;.env 在 .gitignore 里;每个请求都传了 quality;超时 ≥ 600 秒;出错时会打印状态码、报错原文和 request_id。

参考文档:
- 本系列取值与约束:https://ofox.io/zh/docs/develop/models/gpt-image
- 接口通用结构:https://ofox.io/zh/docs/api/openai/images

按它的提示把 Key 填进文件

这一步在做什么: 让 Key 只存在你电脑上的文件里,不出现在对话里。

编程助手会告诉你 .env 文件在哪。打开它,把 Key 粘贴到 OFOX_API_KEY= 后面,保存,然后回复它「填好了」。

看它生成第一张图

这一步在做什么: 确认一切接好了。

编程助手会先生成一张测试图,告诉你保存在哪。能打开就说明接好了,之后直接用对话告诉它你想要什么图。

这两段提示词替你挡掉了哪些坑

要求不写会怎样
Key 放进 .env,不发在对话里Key 可能被写进代码、上传到网上
模型 ID 从文档复制大小写写错会返回 404
默认用 low 画质模型自己选档,画质和费用不稳定
超时 600 秒高画质可能需要数分钟,提前断开会丢失图片,但仍会计费
打印完整报错编程助手只看到「请求失败」,只能猜原因
两次不成功就停编程助手反复重试,每次都在花钱

出错了怎么办

这一步在做什么: 让编程助手自己查出原因并修好。大多数报错,它看到报错原文就能自己解决。

出错时,把下面这段发给它:

排查提示词

生图出错时发给编程助手。

刚才生图出错了。请按顺序排查,并用大白话告诉我结果:
1. 打印这次请求的 HTTP 状态码和完整报错(Authorization 头打码)。
2. 读 error.message,对照 https://ofox.io/zh/docs/develop/models/gpt-image#errors 找到原因。
3. 只改一处,用 quality=low、size=1024x1024 重试一次。
4. 还不行就停下来,告诉我出了什么问题,并把 request_id 和报错信息原文给我。

还是解决不了的话,联系 OfoxAI 时附上编程助手给你的 request_id 和报错信息,我们可以直接查到这次请求。不要发送 Key 本身。

常见问题

我的工具能用 GPT Image 生图吗?

聊天、绘图客户端要满足两点:有「绘画」「生图」入口,并且这个入口能选你自己添加的服务商和模型。有些工具的绘图只能用它自带的模型,这类工具接不了。Claude Code、Codex、ZCode、OpenClaw 这类编程助手都可以:把本页的提示词发给它,它会写一个小脚本帮你生图。

Cherry Studio 怎么配置 GPT Image 绘画?

在 Cherry Studio 里添加 OpenAI 类型的服务商,API 地址填 https://api.ofox.io/v1,填上 Key。然后手动添加模型 openai/gpt-image-2.5-flare,添加时把「端点类型」选成「图像生成 (OpenAI)」,模型才会出现在「绘画」里。

LobeHub 能用 GPT Image 生图吗?

能,但要用 LobeHub 内置的 OpenAI 服务商:把 API 代理地址改成 https://api.ofox.io/v1,填上 Key,生图时选 GPT Image 2。LobeHub 自己添加的模型不能设成图像类型,所以不要新建服务商。GPT Image 2.5 两款还不在它的内置列表里。

工具提示连接失败或 404 怎么办?

先检查三项:API 地址是否填了 https://api.ofox.io/v1(少数工具如 NextChat 要去掉 /v1);Key 是否完整复制、没有多余空格;模型 ID 是否从文档原样复制,大小写都对。

生一张图要多少钱、多久?

按画质计费。按 OpenAI 官方参考价,一张 1024x1024 的图,low 不到 1 美分,gpt-image-2 的 high 约 21 美分。生成耗时随画质和尺寸变化,高画质可能需要数分钟。实际扣费以每次请求的用量为准,OfoxAI 实时价格见模型页。建议先用 low 确认能出图,再按需要调高。

不小心把 Key 发在对话里了怎么办?

去 OfoxAI 控制台删掉这个 Key,新建一个,再按提示填进工具设置或 .env 文件。删掉之后,旧 Key 就不能再用了。

Last updated on