Appearance
ChatGPT API国内怎么用?API Key、价格、调用方式与安全避坑指南(2026)
更新时间:2026 年 11 月 18 日。本文面向需要在网站、脚本、插件或业务系统中调用模型的开发者,整理 ChatGPT API 国内使用、API Key、价格、Python、JavaScript 和 curl 调用方法。模型名称、地区可用性、价格、限额与控制台界面会变化,请以 OpenAI 官方文档和账号页面的实时说明为准。
先给结论:ChatGPT API 入口在哪里?
ChatGPT 网页版和 ChatGPT API 不是同一个入口:
- 普通对话入口是 chatgpt.com;
- API 项目、密钥、用量和账单通常在 platform.openai.com 管理;
- 开发者文档入口是 developers.openai.com;
- 官方价格页面以 OpenAI API Pricing 的实时内容为准。
如果你只是想聊天、写作或上传文件,不需要先申请 API Key;如果你要让程序自动发起请求,就需要在开发者平台创建项目、配置密钥,并按 API 的用量规则计费。
国内开发者的快速选择
如果官方 API 的注册、网络或结算条件在你所在地区无法顺利完成,可以先了解具备 API 接入能力的第三方服务。比如 zeoapi.com 提供独立的第三方 API 入口,适合希望通过统一接口进行开发测试的用户。它不是 OpenAI 官方平台,模型映射、价格、额度、日志策略和可用性都要以 ZeoAPI 实时页面及服务条款为准。
一、ChatGPT、Plus、Pro、Codex 与 API 有什么区别?
很多人搜索“ChatGPT API”时,实际混淆了网页会员、开发者接口和编程工具。可以先按下面的方式区分:
| 产品或入口 | 主要用途 | 是否等同于 API 额度 |
|---|---|---|
| ChatGPT 网页版 | 人在网页中对话、写作、文件分析和图片任务 | 不等同于 API 余额 |
| ChatGPT Plus / Pro | 提供特定网页功能和账号套餐权益 | 不自动等同于不限量 API |
| ChatGPT API | 程序通过 HTTP 或 SDK 调用模型 | 使用独立的 API 项目与用量规则 |
| Codex | 在开发工作流中辅助读代码、改代码和执行任务 | 是否包含额度取决于对应账号或服务方案 |
| 第三方 API 服务 | 由第三方提供兼容接口或聚合入口 | 由第三方单独管理账号、价格和额度 |
简单说,开通 ChatGPT Plus 或 Pro,不代表程序可以无限调用 API;拥有 API Key,也不代表自动拥有 ChatGPT 网页会员。购买或配置前,先确认自己需要的是浏览器体验、Codex 开发额度,还是一个能写进程序的接口。
二、官方 ChatGPT API 使用流程
官方控制台的菜单名称可能随产品更新调整,但整体流程通常可以按下面的顺序理解。
1. 从官方开发者入口开始
打开 platform.openai.com 或 developers.openai.com,先确认地址栏的根域名。不要从搜索结果中的陌生“API 登录页”输入密码,也不要把 API Key 发送给客服、群聊或第三方网页。
2. 创建或选择项目
在开发者控制台中创建项目或选择已有项目,然后查看当前账号可用的模型、区域、用量和权限。不同账号、组织和地区可能显示不同的功能,不要照搬旧截图中的菜单名称。
3. 创建 API Key 并立即保存
API Key 通常只适合在创建后立即复制保存。建议:
- 使用专门的项目密钥,不要多人共用一个长期密钥;
- 只把密钥放在服务器环境变量或密钥管理服务中;
- 不要写进 HTML、浏览器 JavaScript、移动端安装包或公开 Git 仓库;
- 为不同环境分别配置开发、测试和生产密钥;
- 一旦泄露,立即撤销并重新生成。
4. 从文档和控制台确认模型标识
模型名称、版本、上下文限制和工具能力会调整。代码中不要盲目复制几个月前的模型名,建议把模型放进环境变量:
text
OPENAI_API_KEY=你的密钥
OPENAI_MODEL=控制台当前可用的模型标识这样更换模型时只需要调整部署配置,不必修改业务代码。正式上线前还应记录请求耗时、错误类型、输入输出用量和预算告警,但日志中不能记录完整 API Key 或敏感用户内容。
三、ChatGPT API 价格怎么计算?
ChatGPT API 通常按接口请求和模型用量计算,不能简单等同于 ChatGPT Plus 或 Pro 的月费。实际成本可能受到以下因素影响:
- 输入 Token 数量;
- 输出 Token 数量;
- 所使用的模型和上下文长度;
- 图片、音频、文件或工具调用等额外能力;
- 缓存、批处理、速率限制和组织级别的计费规则;
- 第三方 API 服务的套餐、汇率、服务费和额度规则。
价格会变化,本文不写死某个模型的单价。查询时优先看 OpenAI API Pricing,并在控制台检查项目余额、使用量和限额。上线前可以先做一个小规模测试:固定输入长度,记录请求次数、输入输出 Token、平均耗时和失败率,再估算每天和每月成本。
API 和 ChatGPT Plus 的费用不要混算
如果你只在网页里使用 ChatGPT,关注账号内显示的免费、Plus 或 Pro 方案;如果你的程序通过 API 发请求,则要单独关注 API 项目的付款方式、余额、限额和用量。第三方 API 入口也有自己的计费系统,不能把第三方套餐描述成 OpenAI 官方价格。
四、ChatGPT API Python 调用示例
下面示例采用环境变量读取密钥,模型标识使用占位符。先安装官方 Python SDK,并把 OPENAI_API_KEY 和 OPENAI_MODEL 配置在运行环境中。
bash
pip install openaipython
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])
response = client.responses.create(
model=os.environ["OPENAI_MODEL"],
input="请用中文解释 API Key 为什么不能放在前端代码中。"
)
print(response.output_text)这个示例只演示最小调用流程。生产项目还需要补充超时、重试、限流、异常处理、请求追踪、敏感信息过滤和成本监控。不要把用户提交的原始密码、身份证号码、支付信息或私钥直接拼进 Prompt。
五、ChatGPT API JavaScript / Node.js 调用示例
Node.js 项目同样建议在服务器端调用,使用环境变量保存密钥:
bash
npm install openaijavascript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
});
const response = await client.responses.create({
model: process.env.OPENAI_MODEL,
input: "请列出接入模型 API 前需要检查的三项安全设置。",
});
console.log(response.output_text);如果前端页面需要调用模型,应让浏览器请求你自己的后端,再由后端访问 API。不要把 OPENAI_API_KEY 放进 VITE_、NEXT_PUBLIC_ 或其他会被打包到浏览器的公开变量中。
六、ChatGPT API curl 调用示例
想先验证网络、Key 和请求格式,可以使用 curl。下面的 MODEL_ID 要替换成控制台当前可用的模型标识:
bash
curl https://api.openai.com/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "MODEL_ID",
"input": "用一句话说明 API 与 ChatGPT 网页版的区别。"
}'Windows PowerShell 可以先设置当前会话变量,再执行等价请求。不要把包含真实密钥的命令复制到截图、工单、博客或公开终端记录中。
七、国内使用 ChatGPT API:官方路线与第三方路线
官方 API 路线
如果你所在地区、账号和付款条件均符合官方要求,可以直接使用官方开发者平台。遇到请求失败时,先分别检查:
- 官方服务是否对当前地区和账号开放;
- API Key 是否属于当前项目,是否已经撤销或过期;
- 模型标识是否仍然可用;
- 项目余额、速率限制和组织权限是否正常;
- 服务器网络、DNS、代理和 TLS 是否能稳定访问接口。
不要使用虚假身份、盗用账号、共享密钥或绕过安全验证。具体开放范围和服务条款应以官方最新说明及当地适用规则为准。
第三方 API 路线
当开发者需要国内网络环境下更容易接入的统一接口时,可能会考虑第三方 API 服务。以 zeoapi.com 为例,使用前建议逐项核对:
- 是否提供清晰的 API 文档、请求地址和模型映射;
- API Key 由谁签发,能否自行撤销和轮换;
- 输入输出是否保存,保存多久,是否用于训练或人工审核;
- 价格、余额、并发、速率限制和退款规则;
- 服务中断时是否有状态页、工单和数据导出方式;
- 是否允许你的业务场景使用,以及是否符合相关服务条款。
ZeoAPI 是第三方服务,不是 OpenAI 官方 API,也不代表 OpenAI 授权。不要把 OpenAI 官方账号密码或官方 API Key 交给第三方;接入前先用无敏感数据的小请求测试返回格式、延迟和错误处理。
八、API 中转和接口兼容的安全检查
“API 中转”“兼容 OpenAI 格式”只描述接入方式,不自动代表服务可信。准备使用任何第三方接口前,可以完成下面的检查:
检查域名与文档
确认 API 请求地址、控制台域名和帮助文档属于同一个运营主体。不要因为接口路径看起来像 /v1/chat/completions 或 /v1/responses,就认为它是 OpenAI 官方接口。
检查密钥权限
优先使用可撤销、可限额、可分项目的密钥。密钥泄露后马上撤销,不要只修改前端代码或删除本地文件。
检查数据处理
对合同、客户资料、源代码、身份证件和内部财务数据先脱敏。确认服务是否保存 Prompt、输出、IP、日志和错误请求,以及是否提供删除机制。
检查成本边界
设置每日预算、单用户限额、最大输入长度和超时。对重试次数设上限,避免网络抖动造成重复扣费。
九、常见错误与排查顺序
| 错误现象 | 常见原因 | 优先处理 |
|---|---|---|
| 401 / invalid API key | Key 错误、撤销或项目不匹配 | 重新生成并检查环境变量,不要把 Key 发给他人 |
| 403 / access denied | 地区、账号、权限或风控限制 | 查官方说明、项目权限和服务状态 |
| 404 / model not found | 模型标识失效或第三方映射不同 | 从当前文档和控制台复制模型标识 |
| 429 / rate limit | 请求过快、额度或并发达到上限 | 限流、指数退避,并检查用量和预算 |
| 5xx / timeout | 服务端或网络暂时异常 | 设置超时与有限重试,记录 request id |
| 返回格式不一致 | SDK、接口版本或第三方兼容层不同 | 固定版本并按当前文档解析响应 |
排查时先用最小请求复现,再逐步加入文件、工具、图片或长上下文。不要一遇到错误就反复创建账号、频繁切换 IP 或把密钥复制到陌生调试网站。
十、ChatGPT API 常见问题 FAQ
ChatGPT API 国内可以使用吗?
能否使用取决于官方服务的地区开放情况、账号权限、网络和付款条件。符合条件时可以按官方开发者文档接入;如果条件不满足,可评估明确标注第三方身份的 API 服务,但要单独核对其条款、隐私、模型映射和额度。
ChatGPT Plus 可以直接调用 API 吗?
不能把 Plus 或 Pro 网页会员简单理解为 API 余额。网页会员和 API 通常是不同的产品与计费体系,开发者应在 API 项目和控制台中查看实际权限、付款与用量。
ChatGPT API Key 应该放在哪里?
放在服务器环境变量或专业密钥管理服务中,不要放到前端 JavaScript、公开仓库、截图、日志或移动端安装包里。泄露后应立即撤销并轮换。
ChatGPT API 价格是多少?
价格取决于模型、输入输出用量、工具和其他计费规则,会随官方调整。请以 OpenAI API Pricing 和账号控制台的实时信息为准,不要依据旧文章中的固定价格做预算。
API 和 Codex 是一回事吗?
不是。API 是程序调用模型的接口;Codex 是面向开发工作流的产品或工具体验,具体额度和接入方式取决于账号与当前方案。需要 Codex 教程可以阅读 Codex 安装与国内使用指南。
第三方 API 可以上传业务数据吗?
不要默认可以。先阅读隐私政策、数据保留和删除规则,使用脱敏样本做测试,并确认合同、客户资料、密钥和未公开源代码是否被允许提交。
结语:先分清入口,再控制密钥和成本
ChatGPT API 的核心不是找到一个“能返回文字”的接口,而是建立可维护的开发流程:从官方文档或明确披露的第三方入口开始,使用独立项目和环境变量管理 Key,按实时价格估算成本,为请求设置超时、限流和预算,并对敏感数据做脱敏。
如果你只想使用网页 ChatGPT,请回到 ChatGPT官网入口指南;如果你要在国内开发环境中测试第三方 API,可以查看 zeoapi.com,但请把它当作独立第三方服务核验,不要与 OpenAI 官方平台混为一谈。
延伸阅读
- ChatGPT官网入口:登录、下载、API地址与真假官网核验
- ChatGPT国内怎么用:官网、网页版、中文版与镜像指南
- ChatGPT中文版怎么用:中文网页、免费入口与国内使用指南
- Codex安装与国内使用教程
- Claude Code国内安装、CLI、VS Code与API指南