openai-python 从安装到跑通第一个 API 请求5 条命令的最短路径【免费下载链接】openai-pythonThe official Python library for the OpenAI API项目地址: https://gitcode.com/GitHub_Trending/op/openai-pythonopenai-python 是 OpenAI API 的官方 Python 库负责把文本生成、语音等 API 调用变成几行 Python 代码就能干的事。这份指南只做一件事帮你在本地装好它并跑通第一个真实的 API 请求。读完你能独立做三件事装 SDK、配密钥、写出真正能跑的最小调用脚本。 动手前的三件事Python、pip 和密钥Python ≥ 3.10用python --version验证输出类似Python 3.12.4就达标版本不够先升级pyproject.toml 里写死了 3.10 的门槛低于它安装会直接失败。pip 可用跑pip --version预期看到 pip 版本号和 Python 路径若提示命令不存在先检查 Python 安装路径有没有进 PATH。API key 已到手把 key 配成环境变量后echo $OPENAI_API_KEY应打印出以sk-开头的 key为空就去 OpenAI 平台先创建一个。[!NOTE] 强烈建议先把依赖圈进虚拟环境避免污染系统 Pythonpython -m venv .venv source .venv/bin/activate # Windows 用 .venv\Scripts\activate 一条命令装好 openai 库默认推荐 PyPI 稳定版不用纠结直接执行pip install openai装的时候库会顺带带上它需要的 HTTP 客户端和依赖链不需要你额外装任何东西。[!TIP]想追新功能或参与开发走源码安装后续git pull再重装即可更新git clone https://gitcode.com/GitHub_Trending/op/openai-python cd openai-python pip install .网络慢的国内环境给 pip 加-i参数指向国内镜像pip install -i 镜像地址 openai装完验证一下确认装成功pip show openai输出里出现Name: openai加上一行版本号Version: x.x.x就算成功。✅ 跑通第一个 API 请求下面这段脚本从环境变量读 key用 Chat Completions 接口向模型问一句话再打印回复——存成call_openai.py直接运行import os from openai import OpenAI client OpenAI(api_keyos.environ[OPENAI_API_KEY]) completion client.chat.completions.create( modelgpt-4o-mini, messages[{role: user, content: 用一句话介绍你自己}], ) print(completion.choices[0].message.content)模型名不用照抄换成你账号里能用的即可脚本逻辑不变。跑通了终端打印一行文字就是模型对你那句提问的回复。没跑通别硬扛直接看下一节。 装不上、跑不通、调不通提示 command not foundPython 没装或没进系统 PATH。先试python3 --version能通就把后续所有命令换成python3/pip3还是不通就安装 Python 3.10安装时记得勾上加入 PATH 的选项。安装时报 Permission deniedpip 想往系统目录写东西但没权限。最干净的做法是先进虚拟环境再装上面那一行 venv 命令别养成加sudo的习惯。返回 Invalid API key / 401key 没在当前 shell 里设置或值前后带了多余空格。重新设置并验证export OPENAI_API_KEYsk-xxxxxxxx echo $OPENAI_API_KEY # Windows 用 set OPENAI_API_KEYsk-...打印内容与配置一致后再重跑脚本。另外别把 key 明文写进脚本代码泄露 key 就跟着泄露环境变量是最低限度的安全线。返回 model does not exist传入的模型名在你的账号下不可用或名字拼错了。换成账号确实有权限的模型如gpt-4o-mini再试。连接超时或 Connection error公司网络或代理拦了出站流量。建一个配置好代理的 httpx 客户端传给OpenAI()构造函数的http_client参数再重跑。你刚完成了三件事装好 openai-python、配好密钥、跑通第一个 API 请求。想往下走有两个方向查 api.md 参考里的完整接口清单或者翻一遍 examples/ 目录下的现成样例流式输出、异步调用都有可以直接抄的写法。【免费下载链接】openai-pythonThe official Python library for the OpenAI API项目地址: https://gitcode.com/GitHub_Trending/op/openai-python创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考