国内用户如何获取 OpenAI API Key：API获取及常见错误解答

OpenAI API Key 获取与使用详解：从入门到精通

OpenAI 正以其 GPT 和 DALL-E 等先进模型引领全球人工智能创新。其 API 为开发者和企业提供了强大的 AI 能力集成途径，催生了从智能聊天到复杂数据分析等前所未有的应用场景。OpenAI API Key 是开启这些能力的关键，它既是身份凭证，也是资源管理和安全保障的核心。然而，安全、高效地获取、管理和使用 API Key 并非易事。本指南旨在提供全面深入的技术指导，系统梳理 OpenAI API Key 的获取、类型、计费、安全及管理策略，助您从入门到精通，安全高效地驾驭 OpenAI 的强大力量。

理解 OpenAI API Key

1 什么是 OpenAI API Key？

OpenAI API Key 是一个唯一且保密的字符串，用于验证您对 OpenAI API（如 GPT-4o、DALL-E 等）的访问权限。当您的应用程序调用 OpenAI 模型时，必须在请求中包含此密钥，以便 OpenAI 服务器验证您的身份、授权访问并进行用量计费。API Key 通常以 sk-... 格式呈现，它如同连接开发者与 OpenAI 尖端 AI 技术的桥梁，屏蔽了底层复杂的机器学习和系统细节。

2 API Key 在访问 OpenAI 服务中的作用
- 身份验证 (Authentication)： 每次 API 调用都需要通过 Authorization: Bearer YOUR_API_KEY HTTP 头部进行验证，以确认请求的合法性。
- 授权与权限管理 (Authorization & Permissions)： API Key 关联着特定的权限。您可以通过项目和密钥设置进行细粒度控制，例如限制模型访问或将其设置为只读。
- 资源计量与计费 (Usage Metering & Billing)： 所有通过 API Key 发起的请求都会被追踪并计量消耗（通常按 token 计费），并计入关联账户。这是按量付费的基础。
3 API Key 的重要性与敏感性

API Key 极其重要且高度敏感。它直接关系到您的账户安全和费用。一旦泄露，可能导致服务被滥用、产生巨额费用、耗尽配额，甚至被用于访问或篡改关联数据。因此，严禁共享 API Key，且绝不能将其暴露于客户端代码（浏览器、移动应用）或公共代码库中。 妥善保管 API Key 是使用 OpenAI 服务的基本前提和持续责任。

获取方式一：通过 OpenAI 官网获取 API Key（国际通用）

1 注册 OpenAI 账户
首先，访问 OpenAI 官网 (openai.com 或 platform.openai.com) 注册账户。您通常需要提供邮箱、密码及手机验证。请注意，API 平台账户（platform.openai.com）与 ChatGPT 用户账户（chatgpt.com）虽然可以使用相同的登录凭证，但服务和计费是独立的。ChatGPT Plus/Team 订阅不直接提供 API 额度，API 使用需要单独设置支付方式并按量付费。
2 导航至 API Key 管理页面
登录平台账户后，通常点击右上角的个人账户菜单，选择“View API keys”或类似选项，即可进入管理页面。
3 生成新的 Secret Key
在管理页面点击“Create new secret key”按钮。为密钥指定一个有意义的名称（如 MyWebApp-Prod）以便管理。确认后，系统将立即生成并显示完整的 Secret Key——这是唯一一次查看机会，务必立即复制并安全存储（如使用密码管理器或安全的环境变量）。 关闭窗口后将无法再次查看。
4 理解 Secret Key 与 API Key ID
生成的 Secret Key (sk-…) 是用于 API 请求认证的敏感凭证，必须严格保密。管理界面列表通常不显示完整的 Secret Key，而是显示密钥名称、创建/使用日期及 API Key ID (key_…)。API Key ID 是密钥的管理标识符，用于在界面或管理 API 中引用特定密钥（如查看用量、配置权限），而不用于认证。

获取方式二：UIUIAPI 助你畅享 OpenAI

国内开发者获取OpenAI API OpenAI API KEY获取新版 GPT-4.5、gpt-image-1 等高级模型通过 API 进行对话与代码示例

关键点说明 API连接：以下模型版本都可使用UIUI API的OpenAI兼容接口（https://sg.uiuiapi.com/v1/images/generations）支持二种模型：gpt-image-1、gpt-4.5

注意事项：用户需要在UIUI API Token页面](https://sg.uiuiapi.com/token)创建自己的API Token

配置 base_url

UIUIAPI 相当于一个中间代理，将你的请求转发到 OpenAI。因此，在使用 OpenAI Python 库时，你需要将 base_url 参数设置为 UIUIAPI 提供的地址。

调用代码示例与安全存储 API Key

现在，您需要将刚才复制的 Secret Key 从临时位置转移到安全的长期存储中。强烈推荐使用环境变量。

Windows：

通过命令提示符 (cmd): 打开 cmd，运行命令 setx OPENAI_API_KEY "YOUR_API_KEY"（将 YOUR_API_KEY 替换为您复制的密钥）。关闭并重新打开一个新的 cmd 窗口后生效。您可以通过 echo %OPENAI_API_KEY% 验证。
通过系统属性:
- 右键点击“此电脑”或“我的电脑”，选择“属性”。
- 点击“高级系统设置”。
- 在“高级”选项卡下，点击“环境变量...”按钮。
- 在“用户变量”区域，点击“新建...”。
- 变量名输入 OPENAI_API_KEY，变量值输入您复制的密钥。
- 点击确定保存。

macOS / Linux (使用 Zsh 或 Bash)：

打开终端。
运行命令 echo "export OPENAI_API_KEY='YOUR_API_KEY'" >> ~/.zshrc（如果您使用 Bash，则替换为 ~/.bashrc 或 ~/.bash_profile）。将 YOUR_API_KEY 替换为您的密钥。
运行 source ~/.zshrc（或对应的 bash 文件）使更改立即生效。
可以通过 echo $OPENAI_API_KEY 验证。

重要提示：确保包含密钥的环境变量配置文件（如 .env 文件）被添加到 .gitignore 中，永远不要提交到代码仓库。

在代码中使用 API Key

设置好环境变量后，OpenAI 官方 SDK（如 Python 和 Node.js 库）通常会自动读取 OPENAI_API_KEY 环境变量。