OpenAI API Key 配置指南：国内开发者完整教程（2026）

OpenAI API Key 怎么申请？怎么配置？为什么国内用不了？这篇教程帮你一站式解决所有配置问题。

OpenAI API Key 申请

要使用 OpenAI 的 API，首先需要一个 API Key：

注册 OpenAI 账号（需要海外手机号验证）
登录 platform.openai.com/api-keys
点击「Create new secret key」生成 API Key

注意：API Key 一旦创建，只显示一次，请立即复制保存。如果忘记，只能重新创建。

Python SDK 配置

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("OPENAI_API_KEY"),
    # 如果你在中国大陆，直接访问官方 API 会很慢或不稳定
    # 建议使用国内中转服务
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

国内访问问题：为什么直接用官方 API 不行？

官方 API 服务器在国外，国内访问延迟高（500ms-3s）
部分地区完全无法连接
信用卡支付问题：无国际信用卡无法充值

解决方案：使用国内中转服务

以 HolySheep 为例，只需要改两个配置：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("HOLYSHEEP_API_KEY"),  # 中转平台的 Key
    base_url="https://api.holysheep.ai/v1"    # 中转地址
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

环境变量配置

创建 .env 文件（记得加到 .gitignore）：

# 方式1：使用国内中转（推荐）
HOLYSHEEP_API_KEY=sk-holysheep-xxxxxxxxxxxx
OPENAI_BASE_URL=https://api.holysheep.ai/v1

# 方式2：使用官方 API（需要代理）
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
# OPENAI_BASE_URL=https://api.openai.com/v1  # 官方默认地址

国内充值方案

官方需要国际信用卡，国内开发者可以选择支持微信/支付宝的平台：

✅ HolySheep：¥1/$1，微信/支付宝秒充值，无最低金额限制
✅ SiliconFlow：支付宝充值，按量计费
❌ 官方 OpenAI：不支持国内支付方式

常见错误排查

Error: Incorrect API key provided

检查：

API Key 是否正确（不要多打空格或换行）
Key 是否是该平台专属格式（如 HolySheep 的 sk-holysheep-xxx）
base_url 是否设置正确

Error: Connection timeout

国内直连官方 API 超时，建议：

换用国内中转服务（如 HolySheep）
或配置可靠的代理服务器

Billing hard limit reached

额度用完了。使用支持微信/支付宝的平台充值，实时到账。

总结

国内开发者使用 OpenAI API 的最优方案：

使用 HolySheep 等国内中转服务
改 base_url 为中转地址
用微信/支付宝充值
¥1/$1，代码零改动，只需改 base_url

👉 OpenAI API 国内使用：用 HolySheep 中转
¥1/$1 · 微信/支付宝 · 国内直连 · OpenAI-Compatible