OpenAI 兼容说明
Real200 完全兼容 OpenAI API 协议，包括请求格式、参数、响应格式和流式传输。
兼容端点
Real200 支持以下 OpenAI API 端点：
| 端点 | 兼容性 | 说明 |
|---|---|---|
POST /v1/chat/completions | ✅ 完全兼容 | 对话补全 |
POST /v1/completions | ✅ 完全兼容 | 文本补全（Legacy） |
POST /v1/embeddings | ✅ 完全兼容 | 文本向量化 |
POST /v1/images/generations | ✅ 完全兼容 | 图像生成 |
POST /v1/audio/transcriptions | ✅ 完全兼容 | 语音转文字 |
POST /v1/audio/translations | ✅ 完全兼容 | 语音翻译 |
GET /v1/models | ✅ 完全兼容 | 模型列表 |
GET /v1/models/{model_id} | ✅ 完全兼容 | 模型详情 |
GET /v1/balance | ✅ 扩展支持 | Real200 余额查询 |
支持的参数
Real200 支持 OpenAI API 的所有标准参数：
Chat Completions 参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 是 | - | 模型名称 |
messages | array | 是 | - | 消息列表 |
temperature | number | 否 | 1.0 | 随机性 (0–2) |
top_p | number | 否 | 1.0 | 核采样 (0–1) |
max_tokens | integer | 否 | 模型默认 | 最大输出 Token 数 |
stream | boolean | 否 | false | 是否流式输出 |
stop | string/array | 否 | null | 停止序列 |
presence_penalty | number | 否 | 0 | 存在惩罚 (-2–2) |
frequency_penalty | number | 否 | 0 | 频率惩罚 (-2–2) |
logprobs | boolean | 否 | false | 是否返回对数概率 |
top_logprobs | integer | 否 | 0 | 返回的对数概率数 |
response_format | object | 否 | - | 响应格式（JSON mode） |
tools | array | 否 | - | 工具定义 |
tool_choice | string/object | 否 | "auto" | 工具选择策略 |
不支持的参数
| 参数 | 说明 | 替代方案 |
|---|---|---|
user | 终端用户 ID | 使用 API Key 区分 |
差异说明
1. 模型名称
Real200 支持的模型名称可能与 OpenAI 官方不同。例如：
# OpenAI 官方
model = "gpt-4o-2024-05-13"
# Real200（使用通用名称，自动路由到最新版本）
model = "gpt-4o"
完整模型列表见模型列表。
2. 余额查询
Real200 扩展了 GET /v1/balance 端点，用于查询账户余额：
curl https://real200.com/v1/dashboard/user/info \
-H "Authorization: Bearer $REAL200_API_KEY"
3. 错误码
Real200 的错误码与 OpenAI 保持一致，部分场景增加了自定义错误码。详见错误码字典。
迁移指南
从 OpenAI 官方迁移到 Real200
只需修改一行代码：
# OpenAI 官方
client = OpenAI(api_key="sk-xxx")
# Real200
client = OpenAI(
api_key="sk-real200-xxx", # 替换为您的 Key
base_url="https://real200.com/v1" # 添加这一行
)
从其他网关迁移
| 来源 | 迁移方式 |
|---|---|
| OneAPI | 直接替换 base_url，API Key 格式不同 |
| API2D | 直接替换 base_url，部分模型名称需要调整 |
| SiliconFlow | 需要调整 model 参数名称 |
详见迁移指南。
支持的 SDK
Real200 兼容所有基于 OpenAI API 协议的 SDK：
| SDK | 语言 | 兼容性 |
|---|---|---|
| openai (official) | Python | ✅ 完全兼容 |
| openai (official) | Node.js | ✅ 完全兼容 |
| go-openai | Go | ✅ 完全兼容 |
| 其他 OpenAI 兼容 SDK | 多种语言 | ✅ 完全兼容 |
使用方式详见：