从 OpenAI 迁移

从 OpenAI 迁移到 Lurus API

改一行 base_url，原有 OpenAI SDK 调用全部接通——无需重写业务逻辑。

5 分钟预计耗时

1 处代码改动

0 次重启

前置条件

已有一个 Lurus API KeyAPI Key访问 API 的密钥凭证，类似于密码。每个 Key 可独立设置配额和权限。了解更多 →（获取方式）。

一处修改

- from openai import OpenAI
-
- client = OpenAI(api_key="sk-openai-...")
+ from openai import OpenAI
+
+ client = OpenAI(
+     api_key="sk-lurus-...",
+     base_url="https://hub.lurus.cn/v1",
+ )

仅此而已。所有 client.chat.completions.create(...) 调用无需改动。

模型名映射

OpenAI 模型	Lurus 推荐平替
gpt-5	gpt-5 (直通) 或 deepseek-chat / claude-sonnet-4
gpt-4o-mini	deepseek-chat / qwen-turbo
gpt-4o	claude-sonnet-4 / gemini-3-pro
o1	deepseek-reasoner
text-embedding-3-small	bge-m3 (本地) / text-embedding-3-small

完整列表见 支持的模型。

上线步骤

1. 验证连通 — 跑一次确认能收到中文回复即成功。

   resp = client.chat.completions.create(
       model="deepseek-chat",
       messages=[{"role": "user", "content": "你好"}],
   )
   print(resp.choices[0].message.content)

2. 灰度切流 — 按比例把流量从 OpenAI 切到 Lurus，逐步从 0.1 → 0.5 → 1.0。

   import os, random
   
   def get_client():
       if random.random() < float(os.getenv("LURUS_TRAFFIC", "0.1")):
           return OpenAI(api_key=os.getenv("LURUS_API_KEY"),
                         base_url="https://hub.lurus.cn/v1")
       return OpenAI(api_key=os.getenv("OPENAI_API_KEY"))

3. 回滚 — 删除 base_url 即回到 OpenAI 调用。不需要重启（按请求生效）。

常见问题

模型名找不到？

去 模型目录 搜，或提 Issue。

函数调用 / JSON 模式支持吗？

Lurus 全量兼容 OpenAI 函数调用 / JSON Schema。

需要组织 ID 吗？

Lurus 不需要 organization 字段，多余不报错。

下一步

下一步

模型目录API 参考鹿贝计费