OpenAI Python库新手安装指南4 步完成安装与首次调用验证【免费下载链接】openai-pythonThe official Python library for the OpenAI API项目地址: https://gitcode.com/GitHub_Trending/op/openai-pythonOpenAI Python库 是 OpenAI API 的官方 Python 工具包覆盖聊天补全、语音、图像等能力同时提供同步与异步两套客户端。本文带你完成四件事检查环境、安装 OpenAI Python库、配置 API 密钥、跑通首次调用。走完这四步你的机器上就有一个可用、可调试、能打印出模型回复的 OpenAI Python 开发环境后续写任何 AI 功能都有底。速览表检查项要求 / 最短命令做对的信号Python 版本≥ 3.10运行python --version输出形如Python 3.10.x或更高包管理工具运行pip --version输出版本号及对应的 Python 路径安装 OpenAI Python库运行pip install openai结尾提示Successfully installed openai-...配置 API 密钥设置环境变量OPENAI_API_KEYecho $OPENAI_API_KEY能回显密钥首次调用验证运行一个chat.completions.create脚本终端打印出模型返回的回复文本路线总览检查 Python 与 pip确认环境达标。用 pip 安装 OpenAI Python库。配置 API 密钥环境变量。运行脚本验证首次调用成功。 检查 Python 与 pip 环境目标确认本机 Python 版本和 pip 状态满足安装条件。操作python --version # 要求 3.10 及以上 pip --version # 确认 pip 可用成功标志第一条命令输出Python 3.10.x或更高版本第二条命令打印 pip 版本号和 Python 安装路径。卡住自救提示command not found→ 换python3 --version试试Linux/Mac 通常只有python3。版本低于 3.10 → 先升级 Python以官方发行版说明为准。建议用虚拟环境隔离依赖python -m venv openai-env后续安装都在该环境中进行。 安装 OpenAI Python库目标把库装进当前 Python 环境。操作pip install openai成功标志输出末尾出现Successfully installed openai-...同时会一并装上 httpx2、pydantic 等依赖。卡住自救网络超时或下载慢 → 换国内镜像源如pip install -i https://pypi.tuna.tsinghua.edu.cn/simple openai以镜像站实际同步版本为准。提示Permission denied→ 用虚拟环境安装避免给 pip 加sudo。想用最新开发版 → 克隆https://gitcode.com/GitHub_Trending/op/openai-python后在仓库目录运行pip install .。[!TIP] 在虚拟环境里安装后终端提示符前会出现环境名。之后所有命令都应在该环境中执行否则装好的库不可见。 配置 API 密钥目标让客户端在运行时自动读到你的密钥代码里不写死敏感值。操作把下面一行中的YOUR_API_KEY换成你自己的密钥后执行export OPENAI_API_KEYYOUR_API_KEY # Linux / MacWindows 命令提示符用set OPENAI_API_KEYYOUR_API_KEYPowerShell 用$env:OPENAI_API_KEYYOUR_API_KEY。成功标志执行echo $OPENAI_API_KEY能完整回显你刚设置的密钥。卡住自救调用时报认证错误 → 先echo确认变量非空再看密钥是否复制完整、账户余额是否充足。新开的终端里变量不见了 →export只对当前终端生效重新执行一次即可要长期生效就写进~/.bashrc或~/.zshrc。报密钥无效或 401 → 到 OpenAI 平台重新生成密钥替换后重新导出。[!TIP] 项目里常用.env文件存放OPENAI_API_KEYYOUR_API_KEY配合 python-dotenv 加载密钥就不会混进源码。 跑通第一次调用目标用最小脚本完成一次真实的 API 请求。操作新建test_openai.py写入from openai import OpenAI client OpenAI() # 自动读取 OPENAI_API_KEY 环境变量 completion client.chat.completions.create( modelgpt-5.5, # 以官方文档列出的可用模型为准 messages[{role: user, content: Say this is a test}], ) print(completion.choices[0].message.content)再执行python test_openai.py。成功标志终端打印出模型返回的一段回复文本。卡住自救报OPENAI_API_KEY缺失 → 说明当前终端没做第 3 步重新export后运行。报No module named openai→ 先确认激活了安装库的那个环境再跑pip list | grep openai核对。提示模型不存在 → 模型名需要以官方文档当前列表为准换一个可用模型名重试。进阶选读用流式输出逐字打印回复给create加一个streamTrue参数就能在生成过程中逐块读取文本边生成边打印适合聊天类交互。仓库自带的 examples/streaming.py 就是现成的完整示范。切换到异步客户端把导入换成from openai import AsyncOpenAI请求前加await就能在 async 应用里并发调用。同步与异步两套客户端能力对齐用法差异见 README 中的 Async usage 章节。收尾到这里环境检查、依赖安装、密钥配置和首次调用验证就都完成了。想继续深入可以按这三个入口走api.md —— 本库完整 API 参考examples/ —— 各类场景的可运行示例src/openai/ —— 库的源码目录【免费下载链接】openai-pythonThe official Python library for the OpenAI API项目地址: https://gitcode.com/GitHub_Trending/op/openai-python创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考