Skip to main content

典型报错

一句话结论:这条错是 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易 的,两边对不上。

三条解法,按你的情况选

最省事的做法是让 Agent 先「学会」API易 再写代码,有两个层级的技能包可选:
1

整站技能包(推荐先装)

让你的 Agent 运行下面这条命令安装 API易 技能包;跑不通就让它直接读 https://docs.apiyi.com/skill.md
这份文件专门写给 AI 看:Base URL、认证方式、模型命名规则、常见坑一应俱全。装完再让它写代码,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。
其它出图 / 视频模型也各有一页「Agent 技能」,都挂在对应模型的文档目录下。文档站左侧导航里找到模型,看有没有名为「Agent 技能」的子页即可。

自己改代码:只改一行

如果你已经有一段 Codex 生成的代码,最小改动是给客户端加上 base_url,其它一律不动:
改完用这条命令验证请求确实到了 API易,能返回模型列表就对了:

常见追问

按顺序排查:
  1. 多处配置:Codex 生成的项目常常同时有 .env、配置文件、代码初始化三处地方,只改了一处,另一处仍是默认值
  2. 环境变量优先OPENAI_BASE_URL 若在系统里已经设成了别的值,会覆盖代码里没写的那一项;用 echo $OPENAI_BASE_URL 看一眼
  3. 改完没重启:进程仍在跑旧配置
  4. 拼写apiyi,不是 apiyiiapiyl
最简单的自证方法:看报错。只要还出现 platform.openai.com,请求就还在打 OpenAI。
把报错原文连同这一页一起发给它。每个文档页右上角都有「复制页面」按钮,把页面内容 + 报错一起贴给 AI,它就能对照着定位是哪一处配置没生效。这是最快的排错路径。
那才轮到查 Key 本身:登录后台「令牌」页确认该 Key 状态为「启用」、余额充足、没有限制模型白名单。完整排查见 为什么提示 API Key 无效?
文生图默认 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 系列总览

参数、价格、接入提示词与常见报错。