什么是 OpenAI 兼容 API?
OpenAI 兼容 API 是指实现了与 OpenAI API 相同规范的 API 端点。这种标准化使开发者能够通过熟悉的接口使用多个 AI 提供商,而无需重写代码。
为什么重要
您不再被锁定在单一提供商上,只需在现有的 OpenAI 客户端代码中更改 API 端点和凭据,即可在不同 LLM 服务之间切换。
切勿在代码中硬编码 API 密钥。 始终使用环境变量或安全的密钥管理服务来存储凭据。
工作原理
| 配置项 | 说明 |
|---|
| Base URL | 提供商的 API 端点(而非 OpenAI 服务器) |
| API Key | 您在提供商处的身份验证凭据 |
| Model Name | 该提供商的特定模型标识符 |
所有兼容的提供商都支持标准的 OpenAI SDK。安装命令:
pip install openai
# 或
npm install openai
推荐配置
使用环境变量来配置 API 客户端:
export OPENAI_COMPATIBLE_BASE_URL="https://api.provider.com/v1"
export OPENAI_COMPATIBLE_API_KEY="your_api_key_here"
export OPENAI_COMPATIBLE_MODEL_NAME="provider-model-name"
然后在代码中使用:
from openai import OpenAI
client = OpenAI(
base_url=os.environ["OPENAI_COMPATIBLE_BASE_URL"],
api_key=os.environ["OPENAI_COMPATIBLE_API_KEY"],
)
具体配置详情请参阅各个提供商页面。