OpenAI API 接入教程：账号、Key、Base URL 与第一次调用（2026）

接入 OpenAI API 只需要四样东西：一个能登录的账号、一把可用的 API Key、一个已开通计费的项目，以及正确的 Base URL 和一次成功调用。听起来简单，真正卡住新团队的通常不是代码，而是账号体系、付款方式和地址拼接。

本文按实际操作顺序走一遍：账号与项目、创建 Key、充值、安装 SDK、用 Responses API 完成第一次调用、查看用量、排查 401 和 429，最后说明如何把 Base URL 切到 OpenAI 兼容网关。文中示例以 Responses API 为主；只支持 Chat Completions 的旧工具，可以按同样思路替换接口。

说明：OpenAI、ChatGPT、GPT 是 OpenAI 的商标。本文以 2026 年 10 月的公开接口行为为例，模型名称、额度和价格以模型价格及官方文档为准。

一、账号、组织、项目分别是什么

OpenAI 平台至少有三层结构，混在一起最容易出错：

账号：登录凭证，决定谁能进入控制台；
组织：计费和使用量的归属单位，团队协作通常按组织管理；
项目：Key、用量和权限的隔离单位，建议按环境或业务拆分。

一个常见误区是把 ChatGPT 订阅当成 API 余额。两者是分开的：订阅解决聊天产品使用权，API 按实际调用另行计费。团队接入前先确认由谁负责账号、谁负责付款、谁持有管理员权限，避免后期换人时找不到 Key 的归属。

二、创建 API Key 的顺序

按下面步骤操作，不要跳步：

用管理员账号登录 API 控制台，确认当前组织正确。
在组织下新建或选择一个项目，按“开发 / 测试 / 生产”拆开。
进入项目的 API Keys 页面，创建新的密钥。
给 Key 起一个能看出用途的名字，例如“生产-客服机器人”。
立即复制完整 Key，存进密码管理器或部署平台的密钥管理里。
按需设置项目权限、预算或额度上限，再保存。

完整 Key 通常只在创建时显示一次。页面上只剩前后几位是正常的，不要指望以后再复制。如果丢失，直接创建新 Key 并停用旧的，不要试图找回。

三、充值、账单与额度

API 采用预付费还是后付费，取决于账号类型和所在地区，具体以控制台显示为准。开通前重点看三件事：

付款方式是否支持你的卡或渠道；
账单周期和发票如何获取；
是否能为项目设置预算提醒和硬性上限。

付款失败是接入阶段的高频问题。卡被拒时，先检查账单地址、持卡人姓名和验证方式，再联系发卡行；不要在短时间内反复提交，部分风控会因此锁定。用网关接入的团队通常可以用人民币充值，具体费率与到账规则以价格页为准，价格会调整，下单前以页面显示为准。

四、安装 SDK 并发出第一个 curl 请求

先安装官方 Python SDK：

python3 -m pip install --upgrade openai
export OPENAI_API_KEY="sk-你的密钥"
export OPENAI_BASE_URL="https://api.openai.com/v1"
export OPENAI_MODEL="从价格页或官方文档复制的模型名"

用 curl 调 Responses API，确认地址、Key 和网络都通：

curl -sS "$OPENAI_BASE_URL/responses" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$OPENAI_MODEL"'",
    "input": "用一句话解释什么是 API 网关。"
  }'

模型名不要凭记忆写，从价格页或官方文档复制当前可用的名称，存进 OPENAI_MODEL 环境变量。返回 200 且响应体里有输出，说明链路已经打通；返回 401 先看 Key，返回 404 先看 Base URL 和模型名。

五、Python 第一次调用

下面用 Responses API 发一条最小请求，并打印文本结果：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url=os.environ.get("OPENAI_BASE_URL", "https://api.openai.com/v1"),
)

resp = client.responses.create(
    model=os.environ["OPENAI_MODEL"],
    input="用三句话介绍你的能力边界。",
)

print(resp.output_text)

如果你的框架只支持 Chat Completions，把调用换成 client.chat.completions.create(...)，消息放进 messages 即可。两种接口的请求路径不同，混用时最容易出现 404。

六、看懂用量与账单

控制台的 Usage 页面通常按项目、模型、时间三个维度展示消耗，并区分输入和输出。接入初期建议每天看一次，重点确认：

哪个项目在消耗；
输入和输出各占多少；
是否有异常的失败重试；
预算提醒是否生效。

调用返回里的请求 ID 要保留到日志里。出现计费争议或故障时，请求 ID 是服务方定位问题的第一手材料。团队还应在应用侧记录用户、功能模块和请求 ID 的对应关系，否则账单只能看到总量，无法归因。

七、401 和 429 怎么排查

401 表示身份不被认可。按顺序检查：请求头是否带 Bearer；Key 是否多了空格或换行；Key 是否已删除或所属项目停用；是不是把网关 Key 发到了官方地址。换 Key 之前先确认请求实际发往哪里，否则可能白忙。

429 有两种含义：限流和余额不足。看响应体里的错误码和响应头，不要一律降速。insufficient_quota 通常指向余额或额度，需要充值或调整项目上限；速率类错误才适合指数退避。重试只对 429、5xx 和网络错误有意义，400、401、403、404 重试只会浪费额度。更完整的排查顺序见OpenAI API 报错排查。

八、官方直连与兼容网关怎么选

维度	官方直连	OpenAI 兼容网关
接入地址	`https://api.openai.com/v1`	网关提供的 Base URL，通常也以 `/v1` 结尾
账号与付款	官方账号，按官方支持的付款方式	注册站内账号，支持人民币充值与发票
网络	取决于本地网络与跨境链路	通常提供国内可访问入口
模型范围	OpenAI 自有模型	可能同时提供多家模型，以价格页为准
计费	官方账单	站内余额与用量记录
故障处理	走官方支持渠道	由网关方排查上游，用户侧保留请求 ID
适合场景	只使用 OpenAI、已有合规付款路径	国内团队、多模型、希望统一账单

选择时不要只看单价。付款是否顺畅、故障时谁处理、模型是否能随时切换，都会影响长期成本。价格会变化，统一以价格页为准。

九、切换到兼容网关：只改 Base URL

切换成本通常比想象中低，因为兼容网关保留了相同的请求格式。操作顺序：

在网关注册并创建 Key，入口是注册页。
把 OPENAI_BASE_URL 改成网关地址，保留 /v1。
Key 换成网关 Key，不要把两套 Key 混用。
模型名从网关价格页复制，不要沿用官方名称碰运气。
先调 /v1/models 和一条最小请求，再切生产流量。
保留官方或备用线路作为降级方案。

“OpenAI 兼容”指请求和响应格式兼容，不代表所有扩展能力完全一致。文件、批处理、工具调用等高级接口是否支持，要逐项看网关文档，不要默认全部可用。兼容范围的细节可以参考OpenAI 兼容 API 说明。

十、Key 安全与上线前检查

Key 泄露的后果是直接产生费用。最低要求：

Key 只放在服务端环境变量或密钥管理服务里，不写进前端代码、不提交到 Git；
按环境拆分 Key，测试和生产不共用；
给每个 Key 标注负责人和用途，离职或换项目时及时停用；
日志里不打印完整 Key，只保留后四位；
定期轮换，发现异常调用立即吊销。

上线前逐项确认：

[ ] 账号、组织、项目归属清楚；
[ ] 付款方式可用，预算提醒已设置；
[ ] Key 存放在环境变量或密钥管理里；
[ ] Base URL 只保留一个 /v1；
[ ] 最小请求返回 200，响应内容正常；
[ ] 429 退避和 5xx 重试已配置；
[ ] 用量日志包含请求 ID、模型和耗时；
[ ] 备用线路和停用 Key 的流程已演练。

十一、常见问题

API Key 和 ChatGPT 订阅是同一回事吗？

不是。订阅和 API 分开计费，API Key 只在 API 平台创建和管理。团队报销时要分清两笔支出。

为什么创建后看不到完整 Key？

完整密钥通常只在创建时展示一次，平台只保留部分字符用于识别。丢失后应新建并停用旧 Key。

Base URL 应该写到哪里？

写到域名加 /v1 为止，不要带 /chat/completions 或 /responses。路径由 SDK 或请求自己拼接，多写一段就会 404。

一个 Key 可以给多个项目用吗？

技术上可以，管理上不建议。按项目或环境拆 Key，才能控制权限、定位用量，并在泄露时缩小影响范围。

国内团队一定要用网关吗？

不一定。取决于付款渠道、网络质量、合规要求和是否需要多模型。只用 OpenAI、已有稳定付款和网络条件的团队，直连也可以；需要人民币结算和统一入口的团队，可以结合OpenAI 兼容 API 说明评估迁移方式。

下一步

先把最小请求跑通，再接入业务。需要人民币充值、统一多模型入口，可以从注册中商起航 AI 网关开始；模型与价格以模型价格为准。