Lazu 文件

Lazu 是統一 AI 模型閘道。你可以用一把 API Key 接入主流模型 provider，同時保留 OpenAI 相容呼叫、原生 provider endpoint、模型發現、額度控管與用量記錄。

Base URL託管版使用 https://api.lazu.ai；自部署時替換成你自己的 API 網域。

模型目錄GET /api/models/catalog 會返回目前 API Key 實際可用的模型與能力。

程式碼範例聊天、串流、多模態、錯誤處理與用戶端封裝。Chat completions同頁閱讀對話請求、stream、tools、usage 與 cache 欄位。

核心流程

在 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`

快速開始

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，而不是猜模型名稱。