典型报错
一句话结论:这条错是 OpenAI 官方服务器返回的,不是 API易 返回的。你的代码目前请求的是
api.openai.com,API易 的 Key 自然会被 OpenAI 拒绝。Key 没坏,是请求地址没改。怎么判断请求没到 API易
两个特征,看到任意一个就能确定:这个问题在「让 AI 编程助手写接入代码」时格外常见:Codex、Cursor、Claude Code 等看到
gpt-image-2.5 这个模型名,默认会按 OpenAI 官方 SDK 的写法生成代码,base_url 用的是 SDK 的默认值 https://api.openai.com/v1。你填进去的 Key 是 API易 的,两边对不上。三条解法,按你的情况选
- ① 会用 Codex / 编程 Agent:装 Skills 让它接
- ② 不会写代码:把提示词丢给 AI
- ③ 不想接入:直接网页出图
最省事的做法是让 Agent 先「学会」API易 再写代码,有两个层级的技能包可选:
1
整站技能包(推荐先装)
让你的 Agent 运行下面这条命令安装 API易 技能包;跑不通就让它直接读 这份文件专门写给 AI 看:Base URL、认证方式、模型命名规则、常见坑一应俱全。装完再让它写代码,
https://docs.apiyi.com/skill.md:base_url 就会自动指向 https://api.apiyi.com/v1。2
GPT-Image 专用出图技能
GPT-Image-2.5 / 2 系列 Agent 技能 页提供一个开箱即用的 Skill:两个文件、一个脚本,覆盖
gpt-image-2.5-flare / gpt-image-2.5-sunburst / gpt-image-2 等六个模型,用 --model 切换,文生图、多图融合、局部重绘都能做。放进 Codex、OpenClaw、Claude Code 等任意能执行命令行的编码 Agent,对它说一句「帮我出一张……」即可,不需要你自己碰 Base URL。自己改代码:只改一行
如果你已经有一段 Codex 生成的代码,最小改动是给客户端加上base_url,其它一律不动:
常见追问
我明明改了 base_url,为什么还报同样的错?
我明明改了 base_url,为什么还报同样的错?
按顺序排查:
- 多处配置:Codex 生成的项目常常同时有
.env、配置文件、代码初始化三处地方,只改了一处,另一处仍是默认值 - 环境变量优先:
OPENAI_BASE_URL若在系统里已经设成了别的值,会覆盖代码里没写的那一项;用echo $OPENAI_BASE_URL看一眼 - 改完没重启:进程仍在跑旧配置
- 拼写:
apiyi,不是apiyii或apiyl
platform.openai.com,请求就还在打 OpenAI。Codex 说它已经按 API易 写了,但报错没变,怎么回事?
Codex 说它已经按 API易 写了,但报错没变,怎么回事?
把报错原文连同这一页一起发给它。每个文档页右上角都有「复制页面」按钮,把页面内容 + 报错一起贴给 AI,它就能对照着定位是哪一处配置没生效。这是最快的排错路径。
到了 API易 之后如果再报 Key 无效呢?
到了 API易 之后如果再报 Key 无效呢?
那才轮到查 Key 本身:登录后台「令牌」页确认该 Key 状态为「启用」、余额充足、没有限制模型白名单。完整排查见 为什么提示 API Key 无效?。
gpt-image-2.5 该用哪个模型名?
gpt-image-2.5 该用哪个模型名?
文生图默认
gpt-image-2.5-flare,改图 / 局部重绘用 gpt-image-2.5-sunburst,两款同价同参数。走量要便宜可以用官逆 gpt-image-2.5-all。六个模型的取舍见 GPT-Image 系列 Agent 技能 页的对比表。相关文档
为什么提示 API Key 无效?
Base URL 与 Key 一一对应的完整原理与各语言示例。
Base URL 怎么填?
OpenAI 加 /v1、Claude 填根域名、Gemini 加 /v1beta。
有没有一键对接功能?
把文档交给 AI 编程助手,让它替你完成对接。
GPT-Image-2.5 / 2 系列总览
参数、价格、接入提示词与常见报错。