openai.api_key填好了脚本还是回一句认证失败。这类报错在 TaoToken 的接入场景里很好定位Key 和 Base URL 都从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 取Python 里只改两行。刚上手 OpenAI SDK 的人容易把这一步想复杂以为要动engine、要换调用方法、要给Completion.create加一堆参数。按那篇《使用中转API调用OpenAI大模型进行AI技术开发》的流程走一遍就会发现真正会出错的只有两处openai.api_key里的your_api_key_here没有换成真实 Keyopenai.api_base指向的地址你既没有账号也没有凭据。认证失败只是这两处的症状不是 SDK 本身的毛病。这篇按排障的顺序写。先把AuthenticationError的几种形态分清楚再回到pip install openai那条命令把「密钥与地址从哪来」整段换掉然后原样重跑那段生成「人工智能介绍」的脚本。prompt和max_tokens保持不动engine的取值按模型广场当时的列表来。最后把原文第三节列的三类坑——密钥错误、网络连不上、请求参数错误——逐条对上号看看每一类在今天会以什么形式出现。1. 先把 AuthenticationError 的报错原文读完别急着换 Key1.1 认证错误、连接错误、参数错误是三种病原文第三节把可能遇到的问题归成三类这个分法到今天仍然好用只是需要把症状和日志对上号。认证类错误最典型的表现是 HTTP 401Python 侧抛openai.error.AuthenticationError消息可能是Incorrect API key provided也可能是No API key provided。这两句差别很大前一句说明 Key 送到了服务端但不被接受后一句说明 Python 根本没把 Key 发出去多数是变量名写错或者 Key 还停在占位符状态没有替换。连接类错误不会给你 401而是APIConnectionError、ConnectTimeout、Max retries exceeded这类字样。它的意思是请求根本没走到对端问题出在地址、DNS、网络出口或者服务端暂时不可用。原文把这一类归为「网络问题检查网络连接并重试」方向对但要补一条先把api_base的值打印出来看一眼很多时候是地址本身写错了而不是网线断了。参数类错误返回 400消息里通常带着字段名比如invalid_request_error、Unrecognized request argument或者直接抱怨engine的取值不合法。这一类最容易被误判成认证问题因为现象都是「跑不起来」。区分方法很简单看报错里有没有提到 Key。没提就别去控制台重发 Key白白浪费一把。1.2 用一段最小脚本把 Key 的有效性单独测出来发现 401 之后最快的动作不是换 Key而是把「调用逻辑」砍掉只留认证部分。下面这段不做生成只发一次最普通的请求把异常信息原样打出来import openai openai.api_base https://taotoken.net/api openai.api_key YOUR_API_KEY print(base:, openai.api_base) print(key head:, openai.api_key[:6], key len:, len(openai.api_key)) try: resp openai.Completion.create( engineYOUR_MODEL_ID, promptping, max_tokens1 ) print(ok:, resp.choices[0].text) except Exception as e: print(type:, type(e).__name__) print(detail:, e)重点看三行输出。base必须正好是https://taotoken.net/api多一个斜杠、多一层/v1都算写错。key head用来确认贴进去的不是带引号的占位符key len用来确认没有前后空格——从网页复制 Key 时行尾空格是高频事故Python 不会替你 trim。异常类型如果是AuthenticationError说明请求已经到达服务端如果抛的是连接类异常说明连地址那一关都没过先别管 Key。2. 回到 pip install openai只换 api_base 与 api_key 两行2.1 库还是那个库装法看你的 SDK 大版本原文的第一条命令是pip install openai。这条命令今天装出来的多半是 1.x 版本而 1.x 里openai.api_base和openai.Completion.create已经不是默认写法api_base变成了客户端构造参数base_url生成接口从Completion迁到了chat.completions。照着原文写却报AttributeError: module openai has no attribute api_base那不是 Key 的问题是版本对不上。想严格按原文形状跑把版本钉住pip install openai1.0想用新 SDK就别硬套旧写法改成客户端模式即可。两种写法的底座是同一个地址填https://taotoken.net/api密钥填你的 Key。另外别让环境里同时留着旧版和新版动代码前先pip show openai看一眼版本号能省掉一整轮瞎猜。2.2 在控制台创建 Key把 api_base 写成 https://taotoken.net/api原文的openai.api_key your_api_key_here是占位符openai.api_base也是一个别人给的地址。排障要做的替换只有这两行具体动作是打开 TaoToken 注册账号进控制台创建一把 API Key 并复制出来然后把脚本里的地址换成https://taotoken.net/api密钥换成这把真实 Key。两个细节值得盯住。第一填进 SDK 的 Base URL 末尾不要带/v1。SDK 会自己拼路径你多写一层就会得到 404而 404 看起来很像权限问题容易把人带偏。第二这个地址上不要附加任何查询参数它是给程序读的不是给浏览器点的参数混进环境变量之后某些 HTTP 客户端会把它当成路径的一部分。给浏览器点的入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 给 SDK 读的地址是https://taotoken.net/api两者职责不同不要互相替代。2.3 可复制的重跑脚本prompt 与调用形状保持原样地址和 Key 换掉之后其余部分尽量别动这样报错消失才能干净地归因到这两行。旧版 SDK 版本如下import openai # TaoToken 兼容通道地址末尾不带 /v1也不加查询参数 openai.api_base https://taotoken.net/api # 在 TaoToken 控制台创建后替换这里 openai.api_key YOUR_API_KEY response openai.Completion.create( # 取值以模型广场当时列表为准原文示例里的旧模型名未必还在 engineYOUR_MODEL_ID, prompt写一段关于人工智能的介绍。, max_tokens100 ) print(response.choices[0].text.strip())新版 SDK 的等价写法from openai import OpenAI client OpenAI( api_keyYOUR_API_KEY, base_urlhttps://taotoken.net/api ) resp client.chat.completions.create( modelYOUR_MODEL_ID, messages[{role: user, content: 写一段关于人工智能的介绍。}], max_tokens100 ) print(resp.choices[0].message.content)两段代码的输出取法不同旧版在response.choices[0].text新版在resp.choices[0].message.content。从旧版切到新版时print那一行也要跟着改否则会在调用成功之后抛一个AttributeError白高兴一场。3. engine 与 max_tokens请求参数那一类错怎么对照3.1 engine 的取值来自模型广场不能照抄示例原文用的是enginedavinci-codex。这个命名属于老一代补全接口的风格能不能用完全取决于服务端当时挂了哪些模型。地址换成https://taotoken.net/api之后engine新版 SDK 里叫model必须是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场里真实列出来的 ID。填一个列表里没有的名字通常会收到 400 级别的「模型不存在」措辞像极了权限不足实际只是名字不对。排障时的操作顺序先打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 看一眼当前有哪些模型挑一个可用的把 ID 复制出来贴回engine或model。不要凭记忆补日期后缀也不要拿别处的旧文档当准模型列表会更新以当时页面为准最省事。3.2 prompt、max_tokens 与返回结构的检查清单参数错误里除了模型名剩下三类也常见。一是prompt类型不对补全接口要字符串聊天接口要messages数组混用会直接报字段错误。二是max_tokens给了 0 或者负数或者大得离谱前者返回空结果后者可能被直接拒绝。三是把temperature、top_p这类参数写成字符串0.7服务端只接受数字。对照检查可以按这张表走检查项正确形态典型报错地址https://taotoken.net/api404、连接失败密钥控制台创建的真实 Key无前后空格401 认证失败模型 ID模型广场当前列表中的值模型不存在、400prompt补全接口传字符串字段类型错误messages聊天接口传对象数组缺少必要字段max_tokens正整数不要给 0返回空或参数非法这张表的价值在于缩短归因路径。报错信息提到哪个字段就查哪一行报错既没提字段也没提 Key先回到地址那一行。4. 换成 https://taotoken.net/api 之后仍然不通的几种情况4.1 地址尾部多了 /v1 或少写了 https这是最隐蔽的一类。不少 SDK 文档让你把base_url写成带/v1的形式于是有人顺手把https://taotoken.net/api改成https://taotoken.net/api/v1结果请求路径被拼成两层返回 404日志里又看不出所以然。记住这里填进工具的 Base URL 就是https://taotoken.net/api末尾不带/v1需要拼路径的部分交给 SDK。另一头少写协议也常见。taotoken.net/api这种没有https://的写法在某些客户端会被当成本地相对路径或者直接抛协议错误。地址和密钥建议放在环境变量里统一管理脚本里只读不写export OPENAI_BASE_URLhttps://taotoken.net/api export OPENAI_API_KEYYOUR_API_KEY注意这两行是给 SDK 读的不要附加任何查询参数也不要把浏览器里那段访问链接塞进来。4.2 Key 复制带空格、权限不足、额度见底401 的第二种成因在 Key 本身。从控制台复制时拖进了行尾空格或换行服务端收到的就是一把错 Key。用前面那段最小脚本打印len(openai.api_key)和你在控制台上看到的字符数对一下差一位都要重贴。如果 Key 完全正确还是被拒就往权限和额度方向看。有的场景会用只读或限定范围的 Key访问范围之外的模型自然被挡。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制台看这把 Key 的状态、可用范围以及最近一次调用有没有被记上账。文档口径与模型上架情况变化时以控制台当时的显示为准不要拿别人的截图当参照。4.3 连接超时与代理相关的读法连接类异常不需要动代码先确认三件事本机能不能正常访问外网、有没有设过全局代理、目标地址是不是被本地防火墙拦了。Python 侧可以临时打开调试日志看真实请求地址import openai import logging logging.basicConfig(levellogging.DEBUG) openai.api_base https://taotoken.net/api日志里会打印实际发出的 URL对照一下有没有被环境变量改写、有没有多出路径。这类问题的排查顺序是「先看地址、再看出口、最后才怀疑服务端」。把AuthenticationError和连接类异常混在一起处理往往会在错误的地方耗掉大半天。5. 重跑通了之后去控制台对一次这次调用5.1 用同一条 prompt 连续跑两次看返回和用量是否同步报错消失只是第一步。把prompt写一段关于人工智能的介绍。、max_tokens100原样再跑一次确认两件事返回的文本非空且连续两次都能稳定出结果。然后回到控制台刷新调用记录看这次请求有没有被记上、消耗的 token 数和脚本里max_tokens的上限是否吻合。这一步能一次验证 Key、地址、模型 ID 三项配置比逐条试要快得多。顺手把脚本里的print换成带时间戳的日志。之后如果同一段代码在别的机器上出问题你至少能看出是配置差异还是服务端抖动不用重新复现一遍。5.2 长期跑脚本要处理的三件小事第一Key 别硬编码进仓库用环境变量或者本地配置文件.env记得写进.gitignore。第二模型 ID 单独抽成常量换模型时只改一处别散落在十几个脚本里。第三明确自己跑的是哪一代 SDKpip freeze留个记录别人接手时不用重新踩版本坑。脚本稳定之后如果调用量会上来可以先到 TaoToken 模型对话 用同一把 Key 发一条测试消息确认模型 ID 和 Base URL 都对得上需要长期写代码或高频调用的到 Coding Plan 看看套餐是否够用Key 的增删、权限与用量核对在 控制台 API Keys 里操作。刚跑通的那次调用现在应该已经能在记录里找到了。
