调用ChatGPT API需要三步:注册OpenAI平台账号并创建API Key、选择合适的模型、安装OpenAI Python库发出请求。 当前旗舰模型是GPT-6 Astra($10/$50每百万token),主力模型GPT-5.6 Sol已降至$4/$20。OpenAI在2026年主推的调用方式是Responses API,而不是旧的Chat Completions API。国内开发者无法直连OpenAI端点,需要通过中转服务或虚拟信用卡解决支付和网络问题。
【快速答案】
- API Key获取:登录
platform.openai.com→ 左侧导航选择API keys → 点击Create new secret key → 复制并立即保存(仅显示一次)。 - 当前主力模型:GPT-5.6 Sol(
gpt-5.6-sol)是最适合大多数开发场景的旗舰模型,2026年8月降价后输入$4/百万token、输出$20/百万token。 - 旗舰模型:GPT-6 Astra(
gpt-6-astra)于2026年9月3日发布,是目前能力最强的模型,输入$10/百万token、输出$50/百万token。 - 成本优化模型:GPT-5.6 Luna(
gpt-5.6-luna)输入仅$0.2/百万token,适合高并发、对成本敏感的批量任务。 - 官方推荐使用Responses API,旧的Chat Completions API仍然可用但不再是首选。
- 国内调用:官方端点不支持直连,需通过API中转服务(人民币充值、兼容OpenAI SDK)或虚拟信用卡+代理方式解决。
第一步:获取API Key
API Key是你调用OpenAI API的唯一凭证,所有请求都需要它来验证身份和计费。
操作步骤:
- 访问
platform.openai.com,用邮箱或Google/Microsoft账号注册。注册可能需要境外手机号验证。 - 登录后,在左侧导航栏中找到 API keys(不是ChatGPT网页版,API Key和ChatGPT订阅是两套独立的系统)。
- 点击 Create new secret key,给Key起一个有辨识度的名称(如“MyApp-Prod”),选择你的项目。
- 点击 Create secret key,系统会显示一串以
sk-开头的密钥。这个密钥只显示一次,关闭后无法再次查看,必须立即复制保存。 - 前往 Billing 页面,充值至少$5用于API调用。API的费用从充值余额中扣除,与ChatGPT Plus/Pro订阅费是分开的。
API Key的安全管理。OpenAI官方帮助文档强烈建议使用环境变量来存储API Key,而不是直接写在代码中。环境变量是在操作系统层面设置的变量,不会被包含在源代码里,从而避免Key被意外上传到GitHub等平台。
推荐的做法是使用 python-dotenv 库,在项目根目录创建一个 .env 文件:
text
OPENAI_API_KEY=sk-your-actual-key-here
然后在 .gitignore 中添加 .env,确保它不会被提交到版本控制。Python代码中这样读取:
python
import os
from dotenv import load_dotenv
load_dotenv()
api_key = os.environ.get("OPENAI_API_KEY")
不要把API Key硬编码在代码里、不要提交到Git、不要在客户端代码中暴露API Key。这些是API Key泄露最常见的三种方式。
第二步:选择模型
OpenAI在2026年对模型体系进行了重大更新。网上很多教程仍然在使用 gpt-4o、gpt-3.5-turbo 等旧模型名称,这些虽然仍然可用,但已经不是当前的主力模型。
以下是截至2026年9月的核心模型对比:
| 模型 | 模型ID | 输入价格 | 输出价格 | 适用场景 |
|---|---|---|---|---|
| GPT-6 Astra | gpt-6-astra | $10/百万token | $50/百万token | 最复杂推理、企业级Agent任务 |
| GPT-5.6 Sol | gpt-5.6-sol | $4/百万token | $20/百万token | 复杂专业任务,大多数开发场景的主力 |
| GPT-5.6 Terra | gpt-5.6-terra | $2/百万token | $12/百万token | 智能与成本之间的平衡选择 |
| GPT-5.6 Luna | gpt-5.6-luna | $0.2/百万token | $1.2/百万token | 高并发、成本敏感的批量任务 |
| GPT-5.5 | gpt-5.5 | $5/百万token | $30/百万token | 上一代旗舰,仍在使用中 |
价格数据来自OpenAI官方定价页。所有GPT-5.6系列模型均支持1.05M token的上下文窗口和128K最大输出。
选择建议:
- 不确定从哪里开始:用
gpt-5.6-terra。它在智能和成本之间提供了最好的平衡,适合大多数开发场景的初始测试。 - 需要最强的推理能力:用
gpt-5.6-sol。这是大多数专业任务的首选旗舰模型。 - 成本敏感、批量处理:用
gpt-5.6-luna。它的价格仅为Terra的十分之一,适合内容摘要、分类、格式转换等不需要深度推理的任务。 - 企业级最复杂任务:用
gpt-6-astra。目前通过Trusted Access Program向企业开放。
第三步:发出第一个Python请求
安装SDK
bash
pip install openai
OpenAI官方Python库要求Python 3.10+。安装后建议同时安装 python-dotenv 管理环境变量。
使用Responses API(推荐)
OpenAI在2026年的官方文档中明确说明:Responses API是当前与OpenAI模型交互的主要方式。它相比旧的Chat Completions API更简洁、更适合工具调用和Agent场景。
python
import os
from dotenv import load_dotenv
from openai import OpenAI
load_dotenv()
client = OpenAI(api_key=os.environ.get("OPENAI_API_KEY"))
response = client.responses.create(
model="gpt-5.6-sol",
instructions="你是一个专业的中文技术助手,回答简洁准确。",
input="用Python写一个快速排序函数,并解释时间复杂度。",
)
print(response.output_text)
代码说明:
client = OpenAI()自动读取环境变量中的OPENAI_API_KEY,不需要手动传入instructions参数替代了旧API中的system消息角色,用于设定模型的角色和行为input参数替代了旧API中的messages数组,直接传入用户消息response.output_text直接提取文本输出,比旧API的response.choices[0].message.content更简洁
使用Chat Completions API(旧方式,仍然可用)
如果你正在维护已有的代码库,Chat Completions API仍然可以使用:
python
from openai import OpenAI
client = OpenAI()
completion = client.chat.completions.create(
model="gpt-5.6-sol",
messages=[
{"role": "developer", "content": "你是一个专业的Python助手。"},
{"role": "user", "content": "用Python写一个快速排序函数。"},
],
)
print(completion.choices[0].message.content)
注意:旧API中 system 角色在2026年的OpenAI新模型中已被 developer 角色替代。如果你仍然使用 {"role": "system", ...},部分新模型可能无法正确处理。
流式输出
对于需要实时显示结果的场景,可以使用流式输出:
python
stream = client.responses.create(
model="gpt-5.6-sol",
input="写一篇300字的产品介绍。",
stream=True,
)
for event in stream:
if hasattr(event, "delta") and event.delta:
print(event.delta, end="", flush=True)
API成本控制:三个立竿见影的省钱技巧
1. 用Prompt Caching降低重复输入成本
OpenAI对缓存输入token提供90%的折扣。如果你在多次请求中发送相同的系统指令或背景资料,这些重复部分会被自动缓存,费用从$4降到$0.4(以Sol为例)。缓存有效期通常为几分钟,适合对话式应用和批量处理。
2. 用Batch API降低批量任务成本
如果你的任务不需要实时响应——比如批量翻译、数据分类、内容摘要——使用Batch API可以享受50%的折扣。提交任务后,OpenAI会在24小时内返回结果。Batch模式下Sol的输入成本降至$2/百万token。
3. 按任务难度选择模型
这是最直接的成本控制方式。不要默认使用旗舰模型。内容摘要和格式转换用Luna($0.2/百万输入token),常规开发用Terra($2),复杂推理才用Sol($4)。不同模型之间的成本差距高达20倍。
国内开发者调用API的三种方案
OpenAI官方API端点在中国大陆无法直连,且官方不支持支付宝或微信支付。以下是目前可行的三种方案及其对比:
| 官方直付 | 虚拟信用卡 | API中转服务 | |
|---|---|---|---|
| 支付方式 | 国际信用卡 | 虚拟Visa/Mastercard | 支付宝/微信 |
| 是否需要翻墙 | 是 | 是 | 否(国内直连) |
| 延迟 | 500ms-2s | 500ms-2s | 视平台而定 |
| 可用模型 | 全部最新模型 | 全部最新模型 | 取决于平台更新速度 |
| 发票 | 海外invoice | 海外invoice | 部分平台提供国内发票 |
| 适用场景 | 已有海外支付能力 | 个人开发者过渡 | 企业和无海外卡的开发者 |
API中转服务是目前国内开发者最省心的方案。中转平台兼容OpenAI SDK,只需要修改 base_url 和 api_key 两行代码:
python
client = OpenAI(
api_key="your-relay-api-key",
base_url="https://api.relay-service.com/v1"
)
其余代码与调用官方API完全一致。选择中转服务时需要关注三点:是否支持你需要的模型、延迟是否可接受、是否提供国内发票。
关于API Key安全:OpenAI官方帮助文档明确建议,API Key应通过环境变量存储,不要硬编码在代码中。如果你将代码托管到GitHub,使用GitHub Secrets来管理密钥。
常见错误与处理方法
| 错误信息 | 原因 | 解决方法 |
|---|---|---|
401 Unauthorized | API Key无效或已过期 | 检查Key是否正确复制,在platform.openai.com确认Key状态 |
429 Too Many Requests | 超过了速率限制 | 检查当前Tier的RPM/TPM限制,等待后重试或申请更高Tier |
insufficient_quota | 账户余额不足 | 前往Billing页面充值 |
model_not_found | 模型名称错误或账户无权访问 | 确认模型ID拼写正确,检查账户是否已获得该模型权限 |
| 连接超时 | 国内直连官方端点 | 使用中转服务或配置代理 |
关于速率限制:新注册的API账户默认处于Tier 1,限制约为500 RPM(每分钟请求数)和500,000 TPM(每分钟token数)。充值$50并等待7天后可以升级到Tier 2,限制放宽到5,000 RPM和450,000 TPM。速率限制按组织级别计算,同一组织下所有API Key共享配额。
下一步:如果你已经成功发出了第一个API请求,下一步最可能遇到的问题是“如何用API实现多轮对话”或“如何让API调用外部工具”。可以查看GPT-Know的OpenAI Responses API进阶教程,了解工具调用(Tool Calling)、结构化输出和Agent工作流的实现方式。
FAQ
API Key和ChatGPT Plus订阅是同一个东西吗?
不是。API Key用于开发者调用,按token用量计费,从独立的API余额中扣除。ChatGPT Plus/Pro是面向用户的网页版和App订阅,按月收费。两者完全独立,互不影响。
GPT-5.6 Sol和GPT-6 Astra有什么区别?
GPT-6 Astra是OpenAI在2026年9月3日发布的最新旗舰模型,能力最强,输入$10/输出$50每百万token。GPT-5.6 Sol是2026年7月发布的主力模型,在大多数开发场景中性价比更高,输入$4/输出$20。除非你的任务确实需要Astra级别的推理能力,否则Sol通常是更经济的选择。
免费账户能用API吗?
可以获取API Key,但新账户通常没有免费额度。你需要充值至少$5才能开始调用。此前OpenAI提供的免费试用额度在2026年的新账户中已不再默认提供。
为什么代码里要写 gpt-5.6-sol 而不是 gpt-5.6?gpt-5.6 是 gpt-5.6-sol 的别名,两者等价。但使用完整的模型ID可以避免歧义,也是官方文档推荐的写法。
国内用中转服务调用API安全吗?
主要风险在于你通过第三方平台传输了请求内容和返回结果。对于包含敏感数据的场景,建议评估平台的数据处理政策。对于公开数据的处理和开发测试,中转服务是便捷的选择。
【资料来源 / 信息核查】
OpenAI API 官方定价页
页面标题:Pricing | OpenAI API
URL:https://developers.openai.com/api/docs/pricing
核查用途:确认GPT-5.6 Sol、Terra、Luna的标准短上下文和长上下文定价、缓存输入折扣、Batch API价格。
OpenAI API 官方模型页
页面标题:Models | OpenAI API
URL:https://developers.openai.com/api/docs/models
核查用途:确认GPT-6 Astra的发布时间(2026年9月3日)、模型ID、定价($10/$50)、上下文窗口(1.05M token),以及GPT-5.6系列各模型的模型ID和参数。
BenchLM
页面标题:OpenAI API Pricing (September 2026): Model & Token Costs
URL:https://benchlm.ai/openai/api-pricing
核查用途:确认GPT-5.6系列全量定价表、GPT-5.6 Sol降价至$4/$20的说明、各模型的上下文窗口。