快速入门
从 OpenAI 迁移
替换 Base URL 与 API Key,并将旧版 SDK 写法升级到当前客户端方式。
Dimleap 兼容 OpenAI Chat Completions 规范。保留现有消息、参数与响应读取逻辑,只调整客户端初始化配置。
最小改动
迁移前
client = OpenAI(
api_key=os.environ["OPENAI_API_KEY"]
)迁移后
client = OpenAI(
api_key=os.environ["APIQIK_API_KEY"],
base_url="https://api.dimleap.cn/v1",
)如果原模型未在 Dimleap 以同名提供,再把 model 替换为模型广场中的标识。其他业务逻辑无需因节点路由而改变。
过时代码检查
以下写法常见于旧教程。它们不符合当前主流 OpenAI 官方 SDK 的客户端初始化方式,建议在迁移时一并升级。
| 语言 | 旧写法 | 当前写法 | 结论 |
|---|---|---|---|
| Python | openai.ChatCompletion.create(...) | OpenAI(...).chat.completions.create(...) | 应升级 |
| Node.js | new Configuration() + OpenAIApi | new OpenAI({...}) | 应升级 |
| 工具调用 | functions / function_call | tools / tool_choice / tool_calls | 使用新结构 |
| Python Base URL | api_base | base_url | 客户端参数 |
| Node.js Base URL | base_url | baseURL | 注意大小写 |
| 流式文本 | message.content | delta.content | 逐块读取 |
Python 迁移模板
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["APIQIK_API_KEY"],
base_url="https://api.dimleap.cn/v1",
timeout=60.0,
max_retries=2,
)
response = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)迁移验证清单
- 验证普通、流式和工具调用三类请求,而不只是单轮文本。
- 核对模型标识、上下文长度、参数支持范围以及返回字段差异。
- 确认业务的超时与重试不会和平台路由重试造成过长等待。
- 以响应中的
usage和控制台账单验证成本计算。 - 上线前观察错误率、P95 延迟与各类
finish_reason。
“接口兼容”不代表所有模型能力完全相同 工具调用、多模态、结构化输出和生成参数的支持程度取决于具体模型。