用户指南
OpenAI 兼容对照表
精确区分 Dimleap 已确认、部分兼容和待确认的 OpenAI 端点、参数、消息角色与响应字段。
Dimleap 已确认兼容 OpenAI Chat Completions 的核心请求和响应结构。“兼容”表示可复用常见 SDK 调用方式，不表示所有 OpenAI 端点、参数或所有模型能力完全相同。
端点状态
| 端点／能力 | 状态 | 说明 |
|---|---|---|
POST /v1/chat/completions | 已确认核心兼容 | 支持标准鉴权、messages、常用生成参数、非流式和流式响应。 |
函数调用 tools | 按模型支持 | 请求结构遵循 OpenAI 风格；必须在模型广场核对目标模型能力。 |
| 视觉消息、JSON 模式、推理字段 | 按模型／部分兼容 | 参数和响应字段可能因上游模型不同而变化。 |
GET /v1/models | 已确认核心兼容 | 返回 { object: "list", data: [{ id, object, created, owned_by }] }；模型名称取 data[].id，created 为固定值。使用有效 API Key，通过 Authorization: Bearer <API_KEY> 访问；缺失或无效密钥返回 401。目录筛选与分页使用无需鉴权的 /v1/public/models。 |
| Embeddings、Images、Audio、Files、Batch、Moderations | 待平台确认 | 不得仅因 OpenAI SDK 中存在相应方法就认为 Dimleap 已支持。 |
| Responses、Assistants、Realtime、Fine-tuning | 未承诺 | 当前文档不提供兼容承诺。 |
Chat Completions 核心字段
| 类别 | 已确认／当前基线 | 需按模型确认 |
|---|---|---|
| 消息角色 | system、user、assistant、tool | developer 及供应商扩展角色。 |
| 生成参数 | model、messages、temperature、max_tokens、stream | seed、logprobs、音频输出和厂商专属参数。 |
| 工具字段 | tools、tool_choice、tool_calls | 并行工具、严格 Schema 与自定义工具类型。 |
| 流式字段 | choices[].delta、finish_reason、结束事件 | stream_options 与流式 usage 的具体返回方式。 |
| 响应对象 | id、choices、usage | 缓存 Token、推理 Token、供应商元数据等扩展字段。 |
SDK 验证基线
- Python 使用当前
openai客户端的OpenAI(...)写法。 - Node.js 使用当前
openai客户端的new OpenAI(...)写法。 - Dimleap 发布时应记录已回归验证的 SDK 版本与日期，并在升级后重新运行示例。
- 应用应忽略未知响应字段，并对可选字段进行空值处理。
迁移原则先使用最小请求验证端点和模型，再逐项加入流式、工具、多模态和结构化参数；不要一次性假设所有高级参数均兼容。