共计 1661 个字符,预计需要花费 5 分钟才能阅读完成。
背景介绍
对于想要使用 ChatGPT API 的开发者来说,选择官方接口网址至关重要。非官方渠道可能存在以下风险:

- 数据安全风险:你的 API 请求可能被第三方截获或滥用
- 服务不稳定:非官方代理可能随时停止服务
- 功能滞后:无法及时获取官方最新功能和更新
官方 API 网址始终是https://api.openai.com/v1,这是唯一由 OpenAI 直接维护和支持的接口地址。
准备工作
1. 注册 OpenAI 账号
- 访问OpenAI 官网
- 点击 ”Sign up” 并完成注册流程
- 验证你的邮箱地址
2. 获取 API 密钥
- 登录后进入API 密钥管理页面
- 点击 ”Create new secret key”
- 立即复制并安全保存 你的 API 密钥(页面刷新后将无法再次查看完整密钥)
3. 确认官方接口网址
所有 ChatGPT API 请求都应发送至:
https://api.openai.com/v1
特别注意:任何声称是 ”ChatGPT API” 但使用其他域名的服务都不是官方渠道。
第一个 API 调用
下面是一个完整的 Python 示例,展示如何调用 ChatGPT API:
import openai
# 设置你的 API 密钥
openai.api_key = "你的 API 密钥" # 替换为你的实际密钥
try:
# 发起 ChatGPT API 请求
response = openai.ChatCompletion.create(
model="gpt-3.5-turbo",
messages=[{"role": "system", "content": "你是一个有帮助的助手"},
{"role": "user", "content": "用简单语言解释量子计算"}
]
)
# 打印 API 响应
print(response["choices"][0]["message"]["content"])
except Exception as e:
print(f"发生错误: {str(e)}")
代码说明:
openai.api_key: 设置你的认证密钥model: 指定使用的模型版本messages: 对话历史列表,包含系统指令和用户输入
错误处理
以下是常见的 API 错误及解决方法:
- 401 Unauthorized: API 密钥无效或过期
- 检查密钥是否正确复制
-
如果怀疑泄露,生成新密钥并停用旧密钥
-
429 Too Many Requests: 超过速率限制
- 免费用户每分钟 3 次请求
-
考虑实现请求队列或缓存响应
-
503 Service Unavailable: 服务器暂时不可用
- 稍后重试
- 检查OpenAI 状态页面
安全最佳实践
API 密钥管理
- 绝不 将 API 密钥提交到版本控制系统
- 使用环境变量存储密钥:
import os
openai.api_key = os.getenv("OPENAI_API_KEY")
请求频率控制
- 免费账户有严格的速率限制
- 建议实现简单的重试逻辑:
import time
def make_request_with_retry(prompt, max_retries=3):
for attempt in range(max_retries):
try:
response = openai.ChatCompletion.create(
model="gpt-3.5-turbo",
messages=[{"role": "user", "content": prompt}]
)
return response
except openai.error.RateLimitError:
if attempt == max_retries - 1:
raise
time.sleep((attempt + 1) * 2) # 指数退避
进阶学习建议
OpenAI 官方文档是深入学习的宝贵资源,重点推荐以下章节:
- Chat completions 指南 – 详细解释对话格式
- 模型文档 – 比较不同模型能力
- 使用限制 – 了解配额和限制
结语
现在你已经掌握了 ChatGPT API 的基础使用方法。建议尝试修改示例代码:
- 改变
system角色的指令,观察对响应的影响 - 构建多轮对话上下文
- 探索不同模型(如
gpt-4)的能力差异
遇到有趣的结果或问题,欢迎在开发者社区分享你的经验。API 的世界充满可能性,祝你探索愉快!
正文完
