认证

所有 Lurus API 请求都需认证。支持两套互补模式，按场景择一：

API Key 最快上手

Bearer Token，适合脚本和个人项目。本页主讲。

OIDC / OAuth2 Token

基于统一身份体系，适合需用户登录的应用、企业 SSO、M2M。见 OIDC 集成 与 PAT / JWT。

认证方式

用 Bearer TokenBearer Token一种 HTTP 认证方式，在请求头中以 "Bearer sk-xxx" 格式携带凭证。An HTTP auth scheme that sends credentials in the Authorization header.，在 HTTP Header 携带 API KeyAPI Key访问 API 的密钥凭证，类似于密码。每个 Key 可独立设置配额和权限。了解更多 →：

Authorization: Bearer sk-your-api-key

请求示例

curl https://hub.lurus.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-chat", "messages": [{"role": "user", "content": "Hi"}]}'

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://hub.lurus.cn/v1",
    api_key="sk-your-api-key",  # 建议改为 os.environ.get("LURUS_API_KEY")
)

Node.js

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://hub.lurus.cn/v1',
  apiKey: 'sk-your-api-key',  // 建议改为 process.env.LURUS_API_KEY
});

完整 SDK 列表见 API 概述 — SDK 支持。

环境变量

推荐用环境变量存储 API Key，避免硬编码：

# .env
LURUS_API_KEY=sk-your-api-key

import os
from openai import OpenAI

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

认证错误

状态码	code	type	常见原因
401 Unauthorized	invalid_api_key	authentication_error	Key 格式错误 / 已禁用或删除 / Authorization Header 格式不正确
403 Forbidden	access_denied	authorization_error	Key 无该模型权限 / 账户已暂停 / 配额已用尽

错误响应 JSON 结构与重试策略见 错误处理。

安全最佳实践

用环境变量

不在代码中硬编码 API Key

不公开

不提交到 Git 仓库

限制权限

只给 Key 必需的最小权限

定期轮换

周期性更换 API Key

监控日志

定期检查 API 调用日志

---

下一步

Chat Completions API错误处理API 概述OIDC 集成