快速开始

本指南将帮助你在 5 分钟内完成 Lurus API 的首次调用。

前置条件

• 一个 Lurus API 账号（点击注册）
• 一个有效的 API Key

第一步：获取 API Key

1. 访问 Lurus 控制台
2. 登录或注册账号
3. 进入「令牌管理」页面
4. 点击「创建新令牌」
5. 复制生成的 API Key（以 sk- 开头）

安全提示

API Key 是敏感凭证，请妥善保管，不要泄露到公开代码仓库。

第二步：发起第一个请求

使用 cURL

curl https://api.lurus.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手。"},
      {"role": "user", "content": "用一句话介绍什么是人工智能。"}
    ],
    "max_tokens": 100
  }'

使用 Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.lurus.cn/v1",
    api_key="sk-your-api-key"
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手。"},
        {"role": "user", "content": "用一句话介绍什么是人工智能。"}
    ],
    max_tokens=100
)

print(response.choices[0].message.content)

使用 Node.js

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.lurus.cn/v1',
  apiKey: 'sk-your-api-key'
});

async function main() {
  const response = await client.chat.completions.create({
    model: 'deepseek-chat',
    messages: [
      { role: 'system', content: '你是一个有帮助的助手。' },
      { role: 'user', content: '用一句话介绍什么是人工智能。' }
    ],
    max_tokens: 100
  });

  console.log(response.choices[0].message.content);
}

main();

第三步：选择合适的模型

Lurus API 支持多种模型，根据你的需求选择：

模型	特点	推荐场景
deepseek-chat	高性价比，中文优秀	日常对话、文本生成
deepseek-reasoner	强推理能力	数学、编程、逻辑推理
gemini-3-pro-preview	多模态，长上下文	图文理解、文档分析
gpt-4o	综合能力最强	复杂任务、专业领域
claude-3-sonnet	安全、创意写作好	内容创作、长文本

常见问题

Q: 请求返回 401 错误？

检查 API Key 是否正确：

• 确保以 sk- 开头
• 确保没有多余的空格
• 确保 Key 状态为「启用」

Q: 请求返回 "no available server"？

• 检查请求的模型名称是否正确
• 确认你的 Key 有权限访问该模型
• 联系管理员确认渠道配置

Q: 如何切换到其他模型？

只需更改 model 参数即可，无需修改其他代码：

# 切换到 Gemini
response = client.chat.completions.create(
    model="gemini-3-pro-preview",  # 只改这一行
    messages=[...]
)

下一步

• API 详细文档 - 了解完整 API 功能
• 支持的模型列表 - 查看所有可用模型
• 客户端集成 - 配置常用 AI 客户端