用户指南
框架与工具集成
通过自定义 OpenAI Base URL 把 Dimleap 接入常见 AI 框架和开发工具，并用最小请求验证兼容性。
支持自定义 OpenAI Base URL 和 API Key 的工具，通常可以接入 Dimleap。第三方框架可能自动发送额外参数，生产使用前应完成兼容性验证。
通用配置
| 配置项 | 值 | 注意 |
|---|---|---|
| API 类型 | OpenAI-compatible | 优先选择 Chat Completions，而不是未确认的 Responses API。 |
| Base URL | https://api.dimleap.cn/v1 | 某些工具要求填写到 /v1，另一些工具会自动追加版本路径。 |
| API Key | Dimleap API Key | 使用环境变量或安全密钥存储，不写入公开配置。 |
| Model | 模型广场中的准确 ID | 不要假设第三方框架的默认模型在 Dimleap 存在。 |
常见集成方向
LangChain
使用 OpenAI Chat 模型适配器，覆盖普通、流式和工具调用测试。
LlamaIndex
配置 OpenAI-compatible LLM；Embedding 需单独确认，不要默认复用。
Vercel AI SDK
通过 OpenAI provider 的自定义基础地址接入，并验证 SSE 转发。
开发工具
Cursor、Claude Code 等能否接入取决于其自定义 Provider 与端点要求。
验证顺序
- 先发送非流式纯文本请求，验证 URL、密钥与模型。
- 开启流式，确认工具能正确处理增量块和结束事件。
- 如需工具调用，验证参数拼接、tool 消息和多轮循环。
- 检查框架是否偷偷添加 Dimleap 或目标模型不支持的参数。
- 固定已验证的框架版本，并在升级后运行回归测试。