API 概述

Lurus API 完全兼容 OpenAI API 格式，你可以使用任何支持 OpenAI 的 SDK 或工具直接调用。

Base URL

https://api.lurus.cn/v1

认证方式

所有 API 请求需要在 Header 中携带 API Key：

Authorization: Bearer sk-your-api-key

可用端点

端点	方法	描述
/v1/chat/completions	POST	对话补全（最常用）
/v1/completions	POST	文本补全（旧版）
/v1/embeddings	POST	文本向量化
/v1/images/generations	POST	图像生成
/v1/models	GET	获取可用模型列表
/v1/audio/transcriptions	POST	语音转文字
/v1/audio/speech	POST	文字转语音

请求格式

所有请求使用 JSON 格式：

POST /v1/chat/completions HTTP/1.1
Host: api.lurus.cn
Content-Type: application/json
Authorization: Bearer sk-your-api-key

{
  "model": "deepseek-chat",
  "messages": [
    {"role": "user", "content": "Hello!"}
  ]
}

响应格式

成功响应

{
  "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 openai

from openai import OpenAI

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

Node.js

npm install openai

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.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://api.lurus.cn/v1"
client := openai.NewClientWithConfig(config)

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": "user", "content": "Hi"}]}'

特殊功能

流式响应

设置 stream: true 启用 Server-Sent Events 流式响应：

{
  "model": "deepseek-chat",
  "messages": [...],
  "stream": true
}

模型路由

通过模型名称自动路由到对应的上游渠道，无需关心底层配置。

自动重试

请求失败时自动切换到备用渠道（如果配置了多个）。

下一步

• 认证详解
• Chat Completions
• 错误处理