ChatGPT的能力不只局限于网页版对话，通过官方提供的API接口，你可以把大模型能力嵌入到自己的应用、脚本甚至企业系统中。而要使用这套接口，第一步就是获取一个合法的API Key，并完成第一次调用验证环境是否可用。本文将从注册账号开始，一步步演示完整的接入流程。
一、注册OpenAI账号并创建API Key
获取API Key的前提是拥有一个OpenAI平台账号。打开OpenAI的官方网站，点击右上角的注册按钮，使用邮箱完成账号创建。注册过程中需要进行手机号验证，国内手机号可能无法直接通过验证，通常需要借助海外手机号接收验证码。完成注册后登录平台，进入控制台页面。
登录成功后，在左侧菜单中找到API Keys入口，点击页面中的Create new secret key按钮，系统会为你生成一个以sk-开头的密钥字符串。这里要特别注意一点：密钥只在创建的那一刻完整展示一次，关闭弹窗后就再也无法查看完整内容，所以务必立即复制并保存到安全的地方。如果丢失了，只能删除旧密钥重新生成。
新注册的账号通常会赠送少量的免费额度，可以在Usage页面查看余额和消耗明细。如果免费额度已用完，需要在Billing页面绑定信用卡进行充值后才能继续调用。API按token用量计费，输入和输出的token都会计入费用，不同模型的价格差异较大，实际使用前建议先查阅官方的价格说明。
二、首次调用：用Python发送第一轮对话请求
环境准备很简单，Python 3.7以上版本即可。官方提供了SDK，可以先通过pip安装：
pip install openai
安装完成后，编写一个最简单的测试脚本。下面的代码演示了如何设置密钥并发起一次对话补全请求：
from openai import OpenAI
# 创建客户端，密钥也可以通过环境变量 OPENAI_API_KEY 传入
client = OpenAI(api_key="sk-你的密钥")
# 发起一次对话请求
response = client.chat.completions.create(
model="gpt-4o-mini", # 选择模型，可根据需要更换
messages=[
{"role": "system", "content": "你是一个乐于助人的助手。"},
{"role": "user", "content": "用一句话介绍一下你自己"}
],
temperature=0.7 # 控制输出随机性，0到1之间
)
# 输出模型返回的文本内容
print(response.choices[0].message.content)
# 查看本次请求消耗的token数量
print(response.usage)运行这段代码，如果一切正常，终端会打印出模型的回复内容以及token消耗统计。其中messages参数是对话的核心，role为system的消息用于设定模型的人设和行为约束，user消息则是用户的实际提问。多轮对话的实现方式也很直接，把历史消息按顺序追加到messages列表中一并传入即可，模型会根据完整上下文给出连贯的回复。
参数方面还有几个值得了解：temperature越低输出越稳定、越确定，适合问答类任务；越高则更有创造性，适合文案创作。max_tokens可以限制回复长度，避免单次请求消耗过多额度。如果希望模型返回稳定的结构化数据，可以加上response_format参数并要求返回JSON格式。
三、常见报错与排查思路
第一次调用很少有一次成功的，下面几个问题出现频率最高，遇到时可以按对应思路排查。
第一个是401认证失败，报错信息通常包含Incorrect API key provided。出现这个错误说明密钥不正确，可能是复制时带了多余的空格、密钥已被删除，或者环境变量没有生效。先重新生成一个密钥，确认代码中读取到的值是完整的sk-开头字符串。第二个是余额不足，报错代码429或提示quota exceeded，说明账户额度已耗尽，去Billing页面充值或更换账号即可解决。
第三个是网络超时，表现为连接超时或无法建立SSL连接。这通常是网络链路问题，官方接口地址在国内直连并不稳定，可以在创建客户端时指定代理：
from openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="https://api.openai.com/v1", # 可替换为中转服务地址
timeout=60 # 设置超时时间，单位秒
)如果使用的是中转服务，只需修改base_url指向对应的地址即可，其余代码完全不变，这也是SDK设计得比较友好的地方。另外建议不要把密钥硬编码在代码里，尤其是要提交到代码仓库的项目，更稳妥的做法是放在环境变量或配置文件中，并在版本控制中排除该文件，避免密钥泄露被他人盗用产生费用。
跑通第一次调用之后，你就可以在这个基础上扩展流式输出、函数调用、图像识别等更高级的能力了。建议先用小模型跑通业务逻辑，验证效果后再切换到更强的模型，这样能在成本和效果之间取得较好的平衡。
ChatGPT APIAPI KeyOpenAI接口调用修改时间：2026-09-10 16:30:34