OpenAI API Key怎么获取和使用？Python首次调用与计费入门
资料核对：2026年10月10日｜适用于Python和API接入新手
OpenAI API Key怎么获取和使用？先登录开发者平台，确认项目和API账单，再创建项目密钥，把密钥放进环境变量，最后用官方Python库发送一条短请求。购买ChatGPT会员不会自动替你完成这些步骤。
本篇只做一件事：让你理解配置项，并完成一次能检查用量的文字调用。先跑通最小例子，再接聊天工具、自动化或网站，排错会容易很多。
本站原创接入示意图，非开发者平台截图。
先分清API Key、Token和ChatGPT订阅
API Key是程序调用时使用的凭据，Token是模型处理输入输出的计量单位。它们不是同一种东西。所谓“获取Token”，如果指的是借用他人的账号令牌，就不是正规的项目API接入。
ChatGPT与API平台分别计费，会员费用不能直接当作API余额。官方账单管理说明解释了两者的管理入口。API是否有试用、余额或付款要求，以你的开发者账户为准，不要假设新账号一定有免费额度。
第一步：确认项目、权限和账单
进入OpenAI开发者平台，检查当前组织和项目。多人账户可能有多个项目，新手先创建或选择专门的测试项目，并记下它的名称。
在账单和用量相关页面确认能否调用、是否有可用额度，以及当前限制。没有账单权限时，应由组织管理者处理，不要为了调用成功把个人密钥借给团队所有人。
模型名称也要从官方模型文档确认。网页里看见的产品名称不一定就是API模型ID；可用权限、输入输出价格和功能也应一起检查。
第二步：创建项目API Key并保管
在对应项目的密钥管理页面创建一把有明确用途的密钥，例如“本地学习测试”。按实际需要设置权限，并把密钥放到凭据管理工具。完整值的显示方式以当前界面为准，创建时及时保存。
不要把Key写进公开代码、博客、前端网页或截图。一个简单原则是：浏览器访客能下载到的文件里，不应有你的服务端密钥。网站需要调用API时，由后端读取密钥并管理用户请求。
如果已经误发到群聊或公开仓库，应先撤销旧密钥，检查用量，再创建新密钥和更新配置；只删除截图无法让泄露的凭据失效。
第三步：安装Python库并设置环境变量
确认电脑能执行python --version，然后在终端安装官方库：
python -m pip install -U openai
在Windows PowerShell里，可以用无回显输入设置密钥：
$openaiSecret = Read-Host '输入自己的OpenAI API Key' -AsSecureString
$env:OPENAI_API_KEY = [System.Net.NetworkCredential]::new('', $openaiSecret).Password
Remove-Variable openaiSecret
$env:OPENAI_MODEL = Read-Host '输入已确认可用的模型ID'
模型ID从当前文档及项目权限确认后粘贴。使用同一个终端执行后面的程序，因为此处变量只对当前进程及其子进程生效。macOS和Linux也可通过环境变量配置，见官方快速入门。
不要为了确认变量而打印完整密钥。只检查是否存在即可，例如Python中用bool(os.environ.get("OPENAI_API_KEY"))。
第四步：用Responses API发送最小请求
新建openai_test.py，保存为UTF-8：
import os
from openai import OpenAI
client = OpenAI(timeout=30.0, max_retries=0)
reply = client.responses.create(
model=os.environ["OPENAI_MODEL"],
input="请用简体中文、三句话解释什么是API。",
max_output_tokens=1000,
)
print("状态：", reply.status)
print(reply.output_text)
if reply.usage is not None:
print("输入Token：", reply.usage.input_tokens)
print("输出Token：", reply.usage.output_tokens)
然后在同一终端执行：
python openai_test.py
本例按Responses API文档组织，未额外启用搜索或文件工具。max_retries=0便于第一次观察原始错误；日常服务再根据业务需要设置有限重试。
看到文字输出后，去项目用量页面核对这次请求。若状态显示未完成或文本为空，检查响应原因、输出上限和模型说明，而不是只看程序没有报错就认定任务完成。推理模型的输出预算还可能包含推理部分，具体见所选模型文档。
本文提供接入示例，没有替你发起远程模型调用；实际费用和结果以账户记录为准。
第五步：看懂Token费用与预算
基本思路是输入和输出分别计量，再按模型对应的价格计算。若官方按百万Token报价，计算方式是：
基础文字费用 = 输入Token ÷ 1,000,000 × 输入单价
+ 输出Token ÷ 1,000,000 × 输出单价
这是理解基础文字费用的方法，实际账单还可能涉及缓存、工具或其他项目。价格从当前官方页面核对，不要把旧文章里的数字套到新型号。
长对话在再次请求时可能继续发送历史内容，费用不只取决于你刚输入的最后一句。做批量任务前，先测几条代表性材料，再估算总量，并检查平台中的项目或组织限制设置及其实际作用。
第一次报错，优先检查这四项
| 现象 | 常见检查方向 |
|---|---|
| 找不到环境变量 | 是否在配置变量的同一终端运行 |
| 401认证失败 | 密钥是否有效、是否属于当前请求平台 |
| 模型不可用或权限错误 | 模型ID、项目权限及接口支持 |
| 429 | 错误正文中的频率、额度、余额或限制原因 |
不要把任何429都解释成“网络不稳定”。OpenAI的错误代码说明区分了多种原因。完整排查顺序见本站AI API报错指南。
接入第三方工具时，核对地址与凭据
常见配置包括API基础地址、Key和模型ID。OpenAI官方基础地址是https://api.openai.com/v1。若使用第三方服务，应使用该服务自己的凭据与地址，并了解其数据政策；不要把官方Key发送到不明中转域名。
有的工具支持Chat Completions，有的支持Responses。基础地址相同，并不表示工具可以任意切换请求格式。先查工具支持的接口，再选择模型和参数。
常见问题
ChatGPT Plus可以直接调用API吗？
仍需单独管理API项目、凭据和账单。是否有试用或其他权益，应看开发者账户，不能把订阅价格当成API余额。
一把API Key能用于多个程序吗？
权限允许时可能可以，但给不同项目或用途分开创建密钥，更方便查用量、限制权限和撤销。不要多人共享无法区分用途的密钥。
密钥保存在哪个文件最方便？
本地学习可用环境变量或受保护的凭据配置；部署时使用平台提供的秘密变量。不要提交包含密钥的配置文件到版本库。
不想先付费，能怎样学习？
可以了解官方免费层与本地模型路线，先熟悉请求、模型ID和错误处理。把一个最小请求理解清楚，再扩展成自己的工具。
评论