常见错误现象
当您看到类似以下错误信息时：
{
"error": {
"message": "Incorrect API key provided: sk-QqHvK***...",
"type": "invalid_request_error",
"code": "invalid_api_key"
}
}
最常见的错误：使用了 Nebula Lab 的 Key，但请求地址仍然指向 OpenAI 官网 https://api.openai.com
什么是 Base URL？
Base URL（基础 URL / 请求地址）是 API 请求的目标服务器地址。不同的 API 服务提供商使用不同的 Base URL。
Base URL 和 API Key 必须一一对应
| 服务提供商 | Base URL | API Key 格式 | 是否匹配 |
|---|
| Nebula Lab | https://llm.ai-nebula.com | sk-xxxx… | ✅ 正确 |
| OpenAI 官方 | https://api.openai.com | sk-xxxx… | ✅ 正确 |
| ❌ Nebula Key | https://api.openai.com | sk-xxxx… | ❌ 错误 |
| ❌ OpenAI Key | https://llm.ai-nebula.com | sk-xxxx… | ❌ 错误 |
关键原则：使用哪家的 API Key，就必须将请求发送到对应服务商的 Base URL
正确的配置方法
方法一：修改 Base URL（推荐）
from openai import OpenAI
client = OpenAI(
api_key="sk-your-nebula-key", # Nebula Lab 后台获取的 Key
base_url="https://llm.ai-nebula.com/v1" # 改为 Nebula Lab 地址
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好"}]
)
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-your-nebula-key',
baseURL: 'https://llm.ai-nebula.com/v1'
});
const response = await client.chat.completions.create({
model: 'gpt-4o',
messages: [{ role: 'user', content: '你好' }]
});
curl https://llm.ai-nebula.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-nebula-key" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "你好"}]
}'
方法二：使用环境变量
Linux/macOS
Windows PowerShell
Windows CMD
export OPENAI_API_KEY="sk-your-nebula-key"
export OPENAI_BASE_URL="https://llm.ai-nebula.com/v1"
$env:OPENAI_API_KEY="sk-your-nebula-key"
$env:OPENAI_BASE_URL="https://llm.ai-nebula.com/v1"
set OPENAI_API_KEY=sk-your-nebula-key
set OPENAI_BASE_URL=https://llm.ai-nebula.com/v1
支持的请求地址格式
| 格式 | 地址 | 适用场景 |
|---|
| 带 /v1（推荐） | https://llm.ai-nebula.com/v1 | 大多数代码库 |
| 带 /v1/（末尾斜杠） | https://llm.ai-nebula.com/v1/ | 某些框架要求 |
| 完整路径 | https://llm.ai-nebula.com/v1/chat/completions | cURL 请求 |
常见问题排查
可能原因：
- 代码中有多处配置：检查配置文件、环境变量、代码初始化等
- 使用了代理或中间件：某些代理工具可能会重定向请求
- 缓存问题：重启程序或清除缓存后重试
- 拼写错误：确认地址拼写正确
在 Nebula Lab 后台查看：
- 登录 Nebula Lab 控制台
- 进入「令牌」页面
- 检查 Key 状态是否为「启用」
- 确认账户余额充足
大多数第三方工具都有「自定义 API」选项：
- API 地址 / Base URL：
https://llm.ai-nebula.com/v1
- API Key：从 Nebula Lab 后台复制您的 Key
- 模型名称：参考模型列表
错误示例 vs 正确示例
❌ 错误配置
client = OpenAI(
api_key="sk-nebula-key",
base_url="https://api.openai.com/v1"
# ❌ 使用了 OpenAI 官网地址
)
✅ 正确配置
client = OpenAI(
api_key="sk-nebula-key",
base_url="https://llm.ai-nebula.com/v1"
# ✅ 使用 Nebula Lab 地址
)
快速测试方法
使用 cURL 命令快速验证配置是否正确：
curl https://llm.ai-nebula.com/v1/models \
-H "Authorization: Bearer sk-your-nebula-key"
{
"data": [
{
"id": "gpt-4o",
"object": "model"
}
]
}
- API Key 是否正确复制（注意首尾空格）
- 网络连接是否正常
- 账户余额是否充足
记住核心原则：哪家的 Key 配哪家的 URL，Nebula Lab 的 Key 就用 https://llm.ai-nebula.com/v1
