国内 OpenAI API Key 获取与代码调用实战教程：从注册到 API 调用 (附 Python 代码)

OpenAI 正凭借 GPT、DALL-E 等先进模型驱动全球 AI 创新浪潮。其 API 为开发者和企业提供了强大的 AI 能力集成通道，解锁前所未有的应用场景，从智能聊天到复杂数据分析。访问这些能力的核心是 OpenAI API Key——既是身份凭证，也是资源管理和安全的关键。然而，安全高效地获取、管理和使用 API Key 充满挑战。本指南旨在提供全面深入的技术指导，系统梳理OpenAI API Key 的获取、类型、计费、安全及管理策略，助您从入门到精通，安全高效地驾驭 OpenAI 的强大力量。

理解 OpenAI API Key

1.1 什么是 OpenAI API Key？

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

1.2 API Key 在访问 OpenAI 服务中的作用

• 身份验证 (Authentication)：每次 API 调用需通过 Authorization: Bearer YOUR_API_KEY 头进行验证，确认请求合法性。
• 授权与权限管理 (Authorization & Permissions)：密钥关联特定权限，可通过项目（Projects）和密钥设置进行细粒度控制（如限制模型访问或设为只读）。
• 资源计量与计费 (Usage Metering & Billing)：所有通过密钥发起的请求消耗（通常按 token 计）会被追踪并计入关联账户，是按量付费的基础。

1.3 API Key 的重要性与敏感性

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

标准获取方式一：通过“OpenAI官网”获取API Key(国外)

2.1 注册 OpenAI 账户

首要步骤是访问 OpenAI 官网 (openai.com 或 platform.openai.com) 注册账户，通常需要邮箱、密码及手机验证。请注意：API 平台账户 (platform.openai.com) 与 ChatGPT 用户账户 (chatgpt.com) 虽可共用登录凭证，但服务和计费独立。ChatGPT Plus/Team 订阅不直接提供 API 额度，API 使用需单独设置支付方式并按量付费。

2.2 导航至 API Key 管理页面

登录平台账户后，通常点击右上角个人账户菜单，选择“View API keys”或类似选项，即可进入管理页面（直接访问 https://platform.openai.com/api-keys 等链接也可，推荐使用指向项目的链接）。

2.3 生成新的 Secret Key

在管理页面点击“Create new secret key”按钮。为密钥指定一个有意义的名称（如 MyWebApp-Prod）以便管理。确认后，系统将立即生成并显示完整密钥——这是唯一一次查看机会。必须立即复制并安全存储（如密码管理器或安全的环境变量中），关闭窗口后将无法再次查看。

2.4 理解 Secret Key 与 API Key ID

生成的 Secret Key (sk-...) 是用于 API 请求认证的敏感凭证，必须保密。管理界面列表通常不显示完整 Secret Key，而是显示密钥名称、创建/使用日期及 API Key ID (key_...)。API Key ID 是密钥的管理标识符，用于在界面或管理 API 中引用特定密钥（如查看用量、配置权限），不用于认证。

好的，继续优化润色：

获取方式二：国内开发者获取OpenAI API

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

关键点说明

1. 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

安全存储 API Key

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

• Windows:
  • 通过命令提示符 (cmd): 打开 cmd，运行命令 setx OPENAI_API_KEY "YOUR_API_KEY" （将 YOUR_API_KEY 替换为您复制的密钥）。关闭并重新打开一个新的 cmd 窗口后生效 。您可以通过 echo %OPENAI_API_KEY% 验证。
  • 通过系统属性:
    1. 右键点击“此电脑”或“我的电脑”，选择“属性”。
    2. 点击“高级系统设置”。
    3. 在“高级”选项卡下，点击“环境变量...”按钮。
    4. 在“用户变量”区域，点击“新建...”。
    5. 变量名输入 OPENAI_API_KEY，变量值输入您复制的密钥。
    6. 点击确定保存 。
• 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 中，永远不要提交到代码仓库 。

调用OpenAI gpt-image基础文本对话代码示例 ✅

在代码中使用 API Key

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

• Python Example:
  • 首先确保已安装 OpenAI Python 库: pip install openai
  • 创建一个 Python 文件 (e.g., test_openai.py):

from openai import OpenAI

# API key is read automatically from the OPENAI_API_KEY env var
# If the environment variable is not set, you can pass it explicitly:
# client = OpenAI(api_key="YOUR_API_KEY")
# However, using environment variables is strongly recommended.
client = OpenAI()

try:
  response = client.chat.completions.create(
    model="gpt-4o-mini", # Or another available model like gpt-3.5-turbo
    messages=[
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is an OpenAI API Key?"}
    ]
  )
  print("Model Response:")
  print(response.choices.message.content)

  # Show how to check usage from response [12]
  if response.usage:
      print(f"\nTokens used: {response.usage.total_tokens} (Prompt: {response.usage.prompt_tokens}, Completion: {response.usage.completion_tokens})")

except Exception as e:
  print(f"An error occurred: {e}")

• 在终端中运行脚本: python test_openai.py
• cURL Example:
• 在设置了 OPENAI_API_KEY 环境变量的终端中，可以直接使用 $OPENAI_API_KEY 。

curl https://sg.uiuiapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is an OpenAI API Key?"}
    ]
  }'
  

常见问题解答 (FAQ)

• Q1: 为什么我收到 401 Unauthorized 错误？
  • A: 可能原因包括：API Key 不正确或复制粘贴时出错；密钥未正确保存或加载（特别是环境变量未设置或未导出）；密钥已被撤销或删除；账户未激活或支付方式无效。请仔细检查密钥和代码中的配置。
• Q2: 为什么我收到 429 Rate Limit Exceeded 错误？
  • A: 您超出了账户或项目设定的每分钟请求数 (RPM) 或每分钟 token 数 (TPM) 限制。请检查您在 OpenAI 平台的“Limits”页面确认具体限制，并考虑在代码中实施指数退避重试逻辑 。对于大量请求，考虑使用 Batch API 或优化请求批处理 。
• Q3: 为什么我收到 "You exceeded your current quota" 或类似错误？
  • A: 这通常意味着您的账户没有足够的资金来支付 API 调用。可能原因：未添加有效的支付方式；预付费额度已用完；达到了设置的月度硬性预算上限 。请检查您的 Billing 设置，确保有可用资金或额度。
• Q4: 我丢失了我的 Secret Key，可以恢复吗？
  • A: 不可以。出于安全原因，OpenAI 不会存储或允许您再次查看完整的 Secret Key 。如果您丢失了密钥，唯一的办法是生成一个新的 Secret Key，并用新密钥更新所有使用旧密钥的应用程序 。
• Q5: 我可以用我的 ChatGPT Plus/Team 订阅来支付 API 费用吗？
  • A: 不可以。ChatGPT 订阅（如 Plus, Team, Enterprise）和 OpenAI API 平台是分开计费的 。API 使用需要单独设置支付方式（后付费或预付费）并按实际 token 使用量付费 。
• Q6: 我在哪里可以查看我的 API 使用量？
  • A: 您可以在 OpenAI 平台的账户设置下的 “Usage” 页面查看详细的使用情况和成本报告 。这里提供了按时间、模型、API Key 等维度的视图。

OpenAI API Key 是开启人工智能前沿技术大门的钥匙。从个人开发者探索 AI 的无限可能，到大型企业构建复杂的智能应用，理解并熟练管理 API Key 都是不可或缺的基础技能。