ChatGPT API Key 怎么获取？接口调用、价格与国内开发教程【2026年7月更新】

更新时间：2026年7月27日

开发者常说的“ChatGPT API”通常指 OpenAI API。它与 ChatGPT 网页版订阅是两套产品：Plus 或 Pro 不会自动赠送 API 额度，API Key 需要在 OpenAI 开发者平台单独创建，并按模型和实际用量计费。

API 入口怎么选？

方式	入口	适合人群	说明
OpenAI 官方 API	https://platform.openai.com	需要官方账号、模型和文档的开发者	API Key、账单、地区和组织验证按 OpenAI 要求
ZeoAPI	zeoapi.com	需要国内第三方网关或多模型兼容接口的开发者	第三方服务，模型路由、价格、Base URL 和数据政策以控制台为准

ZeoAPI 不是 OpenAI 官方服务。使用第三方 API 时，不要把第三方 Key 提交到 OpenAI 官方接口，也不要默认模型名称、能力和计费与官方完全一致。

一、OpenAI API Key 获取步骤

1. 打开 OpenAI 开发者平台；
2. 登录或创建账号；
3. 根据平台要求完成组织、项目和账单设置；
4. 进入 API Keys 页面；
5. 在对应项目中创建新的 Secret Key；
6. 立即保存密钥，之后通常不能再次查看完整内容；
7. 将密钥设置到服务器环境变量，而不是写进源代码。

官方快速入门：OpenAI API Quickstart。

二、正确设置 OPENAI_API_KEY

Windows PowerShell

setx OPENAI_API_KEY "your_api_key_here"

设置后重新打开终端。只在当前 PowerShell 会话临时使用时：

$env:OPENAI_API_KEY = "your_api_key_here"

macOS / Linux

export OPENAI_API_KEY="your_api_key_here"

生产环境应使用云平台 Secret、CI/CD 密钥库或服务器环境配置，不要把 Key 写入 .env 后提交到 Git。

三、Python 调用 OpenAI API

安装官方 SDK：

pip install openai

创建 example.py：

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-5.6",
    input="用三句话解释什么是向量数据库。",
)

print(response.output_text)

运行：

python example.py

模型名称应以 OpenAI 官方模型目录和你的项目权限为准，不要将第三方平台展示的型号直接复制到官方接口。

四、JavaScript 调用 OpenAI API

安装 SDK：

npm install openai

创建 example.mjs：

import OpenAI from 'openai'

const client = new OpenAI()

const response = await client.responses.create({
  model: 'gpt-5.6',
  input: '给一个适合新手的 JavaScript 异步编程例子。'
})

console.log(response.output_text)

运行：

node example.mjs

API 调用必须放在服务器端。把 Secret Key 写进浏览器 JavaScript、App 安装包或公开网页，会导致任何人都能盗用额度。

五、为什么推荐 Responses API？

OpenAI 当前快速入门使用 Responses API。它适合：

• 文本生成；
• 图片输入与多模态任务；
• 工具调用和 Agent 工作流；
• 会话状态和多步骤任务；
• 图片生成等内置工具；
• 流式输出。

旧项目可以继续评估既有接口，但新项目应优先查看官方最新文档，而不是照搬数年前的 Chat Completions 示例。

六、OpenAI API 怎么计费？

API 不按“问一次多少钱”统一收费，而是按模型的输入、缓存输入、输出 token，以及图片、搜索、容器等工具用量计算。

截至 2026年7月27日，OpenAI 官方价格页对不同 GPT-5.6 系列模型给出不同费率。例如标准短上下文价格中：

模型	输入 / 百万 token	缓存输入 / 百万 token	输出 / 百万 token
gpt-5.6-sol	5 美元	0.50 美元	30 美元
gpt-5.6-terra	2.50 美元	0.25 美元	15 美元
gpt-5.6-luna	1 美元	0.10 美元	6 美元

价格会调整，且长上下文、Priority、Batch、工具和图像任务可能采用不同费率。开发前必须查看 OpenAI 官方价格页。

简单成本估算

总成本 = 输入token成本 + 缓存输入成本 + 输出token成本 + 工具或图片成本

不要只按中文字符数量直接等同 token。实际计费以 API 用量返回和控制台账单为准。

七、如何控制 API 成本？

• 按任务选择模型，不要所有请求都用最高价型号；
• 限制不必要的上下文和历史消息；
• 将稳定的长前缀放在前面，利用 Prompt Caching；
• 设置最大输出并要求简洁格式；
• 批量离线任务评估 Batch API；
• 对用户、项目和接口设置日限额；
• 记录请求 ID、模型、token 和成本；
• 对 429 和 5xx 使用有上限的指数退避；
• 不对输入错误或内容拦截无限重试。

八、国内第三方 API 网关怎么配置？

第三方兼容接口通常需要两项：

API Key
Base URL

以 ZeoAPI 为例，具体注册入口为 zeoapi.com。登录控制台后，应核对：

• 当前 Base URL；
• 模型名称与实际供应商；
• 是否兼容 OpenAI SDK；
• Responses API 或 Chat Completions 支持范围；
• 单价、倍率、并发与限速；
• 日志保存和数据政策；
• 充值、退款和余额有效期；
• 故障时是否会自动切换路由。

Python 兼容接口示意

from openai import OpenAI

client = OpenAI(
    api_key="third_party_key",
    base_url="https://provider.example/v1",
)

response = client.chat.completions.create(
    model="provider-model-name",
    messages=[{"role": "user", "content": "你好"}],
)

上面的 Base URL 和模型名仅为结构示意，必须替换为服务商控制台当前值。不要把第三方服务描述为“OpenAI 官方国内 API”。

九、常见 API 报错

状态或错误	常见原因	处理方式
401	Key 错误、失效或发给了错误域名	核对 Key、Base URL 和项目
403	地区、权限、组织或策略限制	查看平台错误信息和账号状态
404	接口路径或模型不存在	核对 endpoint 和实时模型名
429	速率或余额限制	降低并发、等待并检查账单
400	参数、输入格式或上下文错误	根据错误字段修改请求
5xx	服务临时异常	有限重试并记录 request ID
超时	输出过长、网络或服务负载	缩短任务、流式输出和设置超时

Key 泄露怎么办？

立即在控制台撤销 Key，创建新 Key，检查用量和账单，搜索仓库历史、日志和构建产物，并改用 Secret 管理。

十、API 安全清单

• 每个项目使用独立 Key；
• Key 只放服务器端；
• 不在截图、日志和报错页面显示完整 Key；
• 设置预算告警和用量上限；
• 对外接口加用户认证、频率限制和内容校验；
• 对敏感数据先脱敏；
• 第三方 API 与官方 API 使用不同 Key；
• 定期轮换并删除不用的 Key。

十一、常见问题 FAQ

ChatGPT Plus 包含 API Key 吗？

不包含。ChatGPT 订阅和 OpenAI API 分开计费。

API Key 可以放在前端吗？

不可以。浏览器、移动 App 和桌面安装包中的密钥都可能被提取，应通过自己的后端代理请求。

OpenAI API 有免费额度吗？

不要默认新账号一定赠送额度。以开发者控制台实时余额、活动和账单要求为准。

ZeoAPI 是 OpenAI 官方吗？

不是。它是第三方 API 网关，适合评估多模型和兼容接口，但数据、价格和路由规则由平台管理。

API 用哪个模型最好？

没有统一答案。复杂质量、速度、成本和工具能力要按真实任务评测，建议建立固定测试集比较。

总结

获取 ChatGPT API Key 的正确路径是 OpenAI 开发者平台，使用环境变量保存，并通过官方 SDK 和 Responses API 调用。ChatGPT Plus 或 Pro 不包含 API 额度。

国内开发者需要第三方兼容网关时，可以评估 zeoapi.com，但必须明确其第三方身份，先核对 Base URL、模型路由、单价和数据政策，再用于正式业务。

相关阅读：GPT-5.6 正式发布：OpenAI 最新模型能力、价格、API与国内使用指南。