快速开始

5 分钟跑通第一次调用

获取 Key → 发送请求 → 切换模型，三步搞定。

前置条件

一个 Lurus 账号（注册即得免费配额，第一步带你创建）· Python 3.8+ / Node.js 18+ / Go 1.21+ / cURL（任选）· 基本终端知识。预计 5 分钟。

第一步

注册账号 —— 免费起步

注册即得免费配额，无需充值就能跑通这篇教程。

注册即用，无需付费

新账号自动获得 5 鹿贝 + 免费配额（Free 套餐 100 次/天，含 deepseek-chat、gpt-3.5-turbo），跑通本教程绰绰有余。配额与升级详情见 常见问题 与 计费说明。

接着创建一个 API Key：

1. 访问 hub.lurus.cn，登录或注册

2. 进入「令牌管理」→「创建新令牌」

3. 复制生成的 Key（格式：sk-xxxxxxxxxxxxxxxx）

安全提示

API Key 等同于密码。不要提交到 Git，不要写在前端代码中。推荐通过环境变量传入：

export LURUS_API_KEY="sk-your-key-here"

---

第二步

发送第一个请求

选你的语言，复制即可运行。

看到模型回复了？第一次调用已跑通 🎉

这次请求走的就是注册赠送的免费配额，没花一分钱。下一步换个模型试试 —— 代码几乎不用动。

---

第三步

切换模型

只改 model 参数，无需修改其他任何代码。选一个模型，下面的片段即时更新、复制即跑。

选择模型deepseek-chatdeepseek-reasonerdeepseek-v3-2-251201gemini-3-pro-previewgemini-3-flash-previewgemini-3-pro-image-previewgpt-4ogpt-4o-minigpt-4-turbogpt-3.5-turboclaude-3-5-sonnetclaude-3-opusclaude-3-sonnetclaude-3-haikumidjourneydall-e-364K · ¥1/M tokens

from openai import OpenAI
import os

client = OpenAI(base_url="https://hub.lurus.cn/v1", api_key=os.environ["LURUS_API_KEY"])

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

不知道选哪个？

日常使用 → deepseek-chat（成本最低，中文最好）
复杂推理 → deepseek-reasoner
长文档处理 → gemini-3-pro-preview

完整对比见 支持的模型。

---

常见问题

跑不通？先看这里

返回 401 Unauthorized

{"error": {"code": "invalid_api_key", "type": "authentication_error"}}

检查：

• Key 是否以 sk- 开头
• 请求头格式：Authorization: Bearer sk-xxxx（注意 Bearer 后有空格）
• Key 是否处于「启用」状态（控制台确认）

返回 "no available server"

• 检查 model 名称拼写（区分大小写）
• 确认该 Key 有权限访问此模型
• 如果刚创建 Key，等待约 10 秒后再试

流式响应怎么开启？

在请求体中加 "stream": true，详见 流式响应Streaming流式响应，AI 模型逐 Token 返回结果（而非等全部生成完），降低首字延迟。Server-Sent Events streaming。

下一步

Chat Completions 完整文档支持的模型配置 AI 客户端