OpenAI API 调不通时，先用一个最小请求定位链路，再按“网络—认证—项目权限—模型—请求参数”逐层排查。不要反复换密钥、无限重试或把所有失败都归因于网络。
先运行官方最小请求
按官方快速入门安装最新稳定 SDK，在服务器环境变量配置密钥，然后只发送一条短文本请求。若最小请求成功，问题多半在原业务的参数、工具或文件；若仍失败，再读取 HTTP 状态和错误正文。
from openai import OpenAI
client = OpenAI()
response = client.responses.create(
model="gpt-6-luna",
input="只回复 OK",
max_output_tokens=10,
)
print(response.output_text)
模型名必须在当前项目可用。不要为了排错把 API 密钥打印到终端截图、浏览器或日志。
按状态码决定动作
| 现象 | 优先检查 |
|---|---|
| 连接超时、DNS 或 TLS 错误 | 服务器能否访问官方 API 域名、系统时间与证书链是否正常；不要使用来源不明的反向代理。 |
| 401 | 密钥是否正确、是否已撤销、请求使用的组织和项目是否匹配。 |
| 403 或权限类错误 | 项目权限、模型访问、组织设置及区域/账户要求。 |
| 404 模型相关 | 模型 ID 是否拼错或当前项目不可用。 |
| 429 | 另按速率限制或额度错误码处理，不要无限重试。 |
| 400 | 请求字段、类型、文件格式或端点不符合接口契约。 |
官方错误码指南给出了各类 4xx、5xx 的原因和处理建议。保存失败时间、请求 ID、模型、HTTP 状态和 error.code，足以定位多数问题；Authorization 头和用户隐私内容应脱敏。
验证修复而不是碰巧成功
- 修复后连续发送三次相同最小请求，确认都返回 OK。
- 再逐项加回原业务的模型、长输入、工具或文件，每次只增加一个变量。
- 故意换成无效密钥，系统必须明确失败；若仍显示成功，说明缓存或错误处理有问题。
- 记录最终根因和处理动作，避免下次继续盲目重试。
常见问题
国内网络不能直连怎么办？应先核对 OpenAI 当前支持范围、你的组织资格和合法合规的网络环境。本文不提供绕过访问限制的方法。
换一个密钥就能解决吗？只有密钥错误或撤销时才可能有效；模型权限、账单、参数和网络问题不会靠换密钥自动修复。本文没有访问你的服务器，具体根因要以真实错误响应为准。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/31563.html
