跳至正文
本站为独立中文使用指南,入口、套餐与功能可能变化,请以实际页面为准。
MODEL GUIDES

选择适合你的 AI 模型

先按任务选择模型,再进入对应入口或教程,减少无效尝试。

查看模型动态
AI模型动态

ChatGPT API 怎么用?API Key、模型选择、价格和第一个Python请求

调用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的唯一凭证,所有请求都需要它来验证身份和计费。

操作步骤:

  1. 访问 platform.openai.com,用邮箱或Google/Microsoft账号注册。注册可能需要境外手机号验证。
  2. 登录后,在左侧导航栏中找到 API keys(不是ChatGPT网页版,API Key和ChatGPT订阅是两套独立的系统)。
  3. 点击 Create new secret key,给Key起一个有辨识度的名称(如“MyApp-Prod”),选择你的项目。
  4. 点击 Create secret key,系统会显示一串以 sk- 开头的密钥。这个密钥只显示一次,关闭后无法再次查看,必须立即复制保存。
  5. 前往 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 Astragpt-6-astra$10/百万token$50/百万token最复杂推理、企业级Agent任务
GPT-5.6 Solgpt-5.6-sol$4/百万token$20/百万token复杂专业任务,大多数开发场景的主力
GPT-5.6 Terragpt-5.6-terra$2/百万token$12/百万token智能与成本之间的平衡选择
GPT-5.6 Lunagpt-5.6-luna$0.2/百万token$1.2/百万token高并发、成本敏感的批量任务
GPT-5.5gpt-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-2s500ms-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 UnauthorizedAPI 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的说明、各模型的上下文窗口。

Related Reading

相关阅读

网站地图 ChatGPT 中文版 2026ChatGPT国内版使用教程 2026ChatGPT镜像 ChatGPT 镜像站指南