Lurus API 完全兼容 OpenAI API 格式，你可以使用任何支持 OpenAI 的 SDK 或工具直接调用。
为什么用 Lurus API
OpenAI 兼容
所有端点路径与语义对齐 OpenAI，SDK 零改动直接替换 base_url
完整错误码
每个错误均有 code + message + 建议动作，便于自动化处理
多种认证
Bearer Token / PAT / JWT，脚本到企业 SSO 全覆盖
模型路由与重试
按模型名自动路由上游渠道，失败自动切换备用
接入三步
把 base URL 指向
https://hub.lurus.cn/v1。在请求头携带
Authorization: Bearer sk-your-api-key（获取 API Key）。用任意 OpenAI SDK 发起请求，无需改动业务代码。见下方 SDK 支持。
Base URL
https://hub.lurus.cn/v1认证方式
所有 API 请求需要在 Header 中携带 API Key：
Authorization: Bearer sk-your-api-key认证不止 API Key
可用端点
获取模型列表
/v1/models获取模型列表/v1beta/modelsGemini 格式获取OpenAI格式(Chat)
/v1/chat/completions创建聊天对话OpenAI格式(Responses)
/v1/responses创建响应 (OpenAI Responses API)/v1/responses/compact压缩对话 (OpenAI Responses API)图片生成
/v1/images/generations生成图像(qwen-image)/v1/images/edits编辑图像(qwen-image-edit)视频生成
/v1/videos创建视频 /v1/videos/{task_id}获取视频任务状态 /v1/videos/{task_id}/content获取视频内容/kling/v1/videos/text2videoKling 文生视频/kling/v1/videos/text2video/{task_id}获取 Kling 文生视频任务状态/kling/v1/videos/image2videoKling 图生视频/kling/v1/videos/image2video/{task_id}获取 Kling 图生视频任务状态/jimeng/即梦视频生成/v1/video/generations创建视频生成任务/v1/video/generations/{task_id}获取视频生成任务状态Claude格式(Messages)
/v1/messagesClaude 聊天Gemini格式
/v1beta/models/{model}:generateContentGemini 图片(Nano Banana)/v1/engines/{model}/embeddingsGemini 嵌入(Embeddings)OpenAI格式(Embeddings)
/v1/embeddings创建文本嵌入文本补全(Completions)
/v1/completions创建文本补全OpenAI音频(Audio)
/v1/audio/transcriptions音频转录/v1/audio/translations音频翻译/v1/audio/speech文本转语音重排序(Rerank)
/v1/rerank文档重排序Moderations
/v1/moderations内容审核Realtime
/v1/realtime实时 WebSocket 连接请求格式
所有请求使用 JSON 格式：
POST /v1/chat/completions HTTP/1.1
Host: hub.lurus.cn
Content-Type: application/json
Authorization: Bearer sk-your-api-key
{
"model": "deepseek-chat",
"messages": [
{"role": "user", "content": "Hello!"}
]
}响应格式
每个字段的类型与是否必填见 数据结构参考 / Schema（由 OpenAPI 规范自动同步，与网关实现一致）。
成功响应
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1677858242,
"model": "deepseek-chat",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! How can I help you today?"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 12,
"total_tokens": 22
}
}错误响应
{
"error": {
"code": "invalid_api_key",
"message": "Invalid API key provided",
"type": "authentication_error"
}
}速率限制
| 限制类型 | 默认值 | 说明 |
|---|---|---|
| RPM (请求/分钟) | 60 | 每分钟最大请求数 |
| TPM (Token/分钟) | 100,000 | 每分钟最大 Token 数 |
| 并发请求 | 10 | 最大同时进行的请求 |
超出限制会返回 429 Too Many Requests 错误，处理方式见 错误处理。
SDK 支持
Python (官方 OpenAI SDK)
pip install openaifrom openai import OpenAI
client = OpenAI(
base_url="https://hub.lurus.cn/v1",
api_key="sk-your-api-key"
)Node.js
npm install openaiimport OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://hub.lurus.cn/v1',
apiKey: 'sk-your-api-key'
});Go
import "github.com/sashabaranov/go-openai"
config := openai.DefaultConfig("sk-your-api-key")
config.BaseURL = "https://hub.lurus.cn/v1"
client := openai.NewClientWithConfig(config)cURL
curl https://hub.lurus.cn/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key" \
-d '{"model": "deepseek-chat", "messages": [{"role": "user", "content": "Hi"}]}'特殊功能
网关增强能力
流式响应
设置 stream: true 启用 Server-Sent Events，逐 Token 返回
模型路由
通过模型名称自动路由到对应上游渠道，无需关心底层配置
自动重试
请求失败时自动切换到备用渠道（如果配置了多个）
流式响应
设置 stream: true 启用 Server-Sent Events 流式响应：
{
"model": "deepseek-chat",
"messages": [...],
"stream": true
}完整的流式数据格式与逐 Token 处理见 Chat Completions — 流式响应。
模型路由
通过模型名称自动路由到对应的上游渠道，无需关心底层配置。
自动重试
请求失败时自动切换到备用渠道（如果配置了多个）。