Lazu 文档

Lazu 是统一 AI 模型网关。你可以用一个 API Key 接入主流模型 provider，同时保留 OpenAI 兼容调用、原生 provider endpoint、模型发现、额度控制和用量日志。

Base URL托管版使用 https://api.lazu.ai；自部署时替换成你自己的 API 域名。

模型目录GET /api/models/catalog 返回当前 API Key 真正可用的模型和能力。

代码示例聊天、流式响应、多模态、错误处理和客户端封装。接口调试交互式 OpenAPI Reference，适合按字段查请求和响应结构。

核心流程

在 Lazu 控制台创建 API Key。
调用 GET /api/models/catalog。
根据 modality、supported_endpoint_types、supported_endpoints、pricing、parameters 和 default_endpoint_type 选择模型。
按模型推荐的 endpoint 发起请求。

认证

最通用的鉴权方式：

Authorization: Bearer YOUR_API_KEY

接口类型	推荐鉴权方式
OpenAI 兼容接口	`Authorization: Bearer YOUR_API_KEY`
Anthropic 原生接口	`x-api-key: YOUR_API_KEY` + `anthropic-version`
Gemini 原生接口	`?key=YOUR_API_KEY` 或 `x-goog-api-key: YOUR_API_KEY`

Token 可以限制可访问模型、额度、过期时间和 IP 白名单。给 Agent、脚本或 CI 使用时，建议单独创建受限 Token。

快速开始

curl https://api.lazu.ai/api/models/catalog \
  -H "Authorization: Bearer YOUR_API_KEY"

from openai import OpenAI
 
client = OpenAI(
    base_url="https://api.lazu.ai/v1",
    api_key="YOUR_API_KEY",
)
 
response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello from Lazu"}],
)
print(response.choices[0].message.content)

选模型

GET /api/models/catalog 是当前 token 的事实来源。Agent 和脚本应该优先读取 catalog，而不是猜模型名。