# Lazu Docs

Lazu is a unified AI model gateway for people and agents.

Recommended workflow:
- Use Authorization: Bearer <api-key>
- Call GET /api/models/catalog first
- Choose the model by modality, supported_endpoint_types, supported_endpoints, pricing, and default_endpoint_type
- Then call the matching Lazu endpoint

Important URLs:
- Docs home: https://lazu-next-docs-dev.jiaxicui446.workers.dev
- API Explorer: https://lazu-next-docs-dev.jiaxicui446.workers.dev/api-reference
- OpenAPI JSON: https://lazu-next-docs-dev.jiaxicui446.workers.dev/openapi.json
- Full LLM context: https://lazu-next-docs-dev.jiaxicui446.workers.dev/llms-full.txt

## Documentation pages

- [Lazu Docs](https://lazu-next-docs-dev.jiaxicui446.workers.dev): Unified AI gateway — one key, every major model, transparent per-lane pricing, OpenAI-compatible.
- [Lazu 文档](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/): Lazu API 的认证、模型发现、OpenAI 兼容调用、原生 provider API 和生产排障指南。
- [Lazu 文件](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/): Lazu API 的認證、模型發現、OpenAI 相容呼叫、原生 provider API 與生產排障指南。
- [Lazu ドキュメント](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/): Lazu API の認証、モデル検出、OpenAI 互換呼び出し、provider ネイティブ API、本番トラブルシューティングのガイド。
- [Code Examples](https://lazu-next-docs-dev.jiaxicui446.workers.dev/examples): Lazu API examples for cURL, Python, JavaScript and production troubleshooting.
- [代码示例](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/examples): Lazu API 的 cURL、Python、JavaScript 和生产排障示例。
- [程式碼範例](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/examples): Lazu API 的 cURL、Python、JavaScript 與生產排障範例。
- [コードサンプル](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/examples): Lazu API の cURL、Python、JavaScript、本番トラブルシューティングのサンプル。
- [API Explorer](https://lazu-next-docs-dev.jiaxicui446.workers.dev/api-reference): Try the Lazu API live — pick an operation, paste your key, send a real request from the docs.
- [API Explorer](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/api-reference): 在线试用 Lazu API —— 选择操作、粘贴密钥、直接发起真实请求。
- [API Explorer](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/api-reference): 線上試用 Lazu API —— 選擇操作、貼上金鑰、直接發出真實請求。
- [API Explorer](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/api-reference): Lazu API をライブで試す —— 操作を選び、キーを貼り付けて、本物のリクエストを送信。
- [Changelog](https://lazu-next-docs-dev.jiaxicui446.workers.dev/changelog): Lazu API and documentation updates.
- [更新日志](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/changelog): Lazu API 和文档更新记录。
- [更新日誌](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/changelog): Lazu API 與文件更新記錄。
- [更新履歴](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/changelog): Lazu API とドキュメントの更新情報。
- [Authentication](https://lazu-next-docs-dev.jiaxicui446.workers.dev/authentication): How to authenticate against Lazu — OpenAI-compatible header, Anthropic native, Gemini native.
- [鉴权](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/authentication): Lazu 的 API Key 鉴权方式，包括 OpenAI 兼容、Anthropic 原生和 Gemini 原生调用。
- [認證](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/authentication): Lazu 的 API Key 認證方式，包括 OpenAI 相容、Anthropic 原生和 Gemini 原生呼叫。
- [認証](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/authentication): Lazu の API Key 認証方式。OpenAI 互換、Anthropic ネイティブ、Gemini ネイティブ。
- [How pricing works](https://lazu-next-docs-dev.jiaxicui446.workers.dev/billing): Lazu's billing model, refund rules, partial usage handling, and tier behaviour.
- [计费规则](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/billing): Lazu 的预付费、按 token 计费、退款规则、cache usage 和 tier 行为。
- [計費規則](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/billing): Lazu 的預付費、按 token 計費、退款規則、cache usage 和 tier 行為。
- [料金体系](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/billing): Lazu のプリペイド、token 課金、返金ルール、cache usage、tier の動作。
- [Chat completions](https://lazu-next-docs-dev.jiaxicui446.workers.dev/endpoints/chat): OpenAI-compatible /v1/chat/completions with inline parameters, examples, streaming, tools and cache usage notes.
- [Chat completions](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/endpoints/chat): OpenAI 兼容的 /v1/chat/completions，同页包含参数、示例、流式、工具调用和 cache usage 字段。
- [Chat completions](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/endpoints/chat): OpenAI-compatible /v1/chat/completions，包含參數、stream、tools、usage 和 cache 欄位。
- [Chat completions](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/endpoints/chat): OpenAI-compatible /v1/chat/completions。parameters、stream、tools、usage/cache fields。
- [Embeddings](https://lazu-next-docs-dev.jiaxicui446.workers.dev/endpoints/embeddings): OpenAI-compatible /v1/embeddings with request fields, batch inputs, dimensions and examples.
- [Embeddings](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/endpoints/embeddings): OpenAI-compatible /v1/embeddings，请求字段、批量输入、维度和响应说明。
- [Embeddings](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/endpoints/embeddings): OpenAI-compatible /v1/embeddings，請求欄位、批次輸入、維度和響應說明。
- [Embeddings](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/endpoints/embeddings): OpenAI-compatible /v1/embeddings。request fields、batch inputs、dimensions。
- [Files API](https://lazu-next-docs-dev.jiaxicui446.workers.dev/endpoints/files): Upload PDFs, images and documents, then reference file_id values from the Responses API.
- [Files API](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/endpoints/files): 上传 PDF、图片和文档，然后在 Responses API 中通过 file_id 引用。
- [Files API](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/endpoints/files): 上傳 PDF、圖片和文件，然後在 Responses API 中透過 file_id 引用。
- [Files API](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/endpoints/files): PDF、画像、documents を upload し、Responses API から file_id で参照する。
- [Models list](https://lazu-next-docs-dev.jiaxicui446.workers.dev/endpoints/models): OpenAI-compatible /v1/models plus guidance on when to use the richer /api/models/catalog.
- [模型列表](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/endpoints/models): OpenAI-compatible /v1/models，以及什么时候应该改用更完整的 /api/models/catalog。
- [模型列表](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/endpoints/models): OpenAI-compatible /v1/models，以及什麼時候應該改用更完整的 /api/models/catalog。
- [モデル一覧](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/endpoints/models): OpenAI-compatible /v1/models と、より詳しい /api/models/catalog を使うべき場面。
- [Responses API](https://lazu-next-docs-dev.jiaxicui446.workers.dev/endpoints/responses): OpenAI-compatible /v1/responses with file_id dereferencing, reasoning controls, request fields and examples.
- [Responses API](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/endpoints/responses): OpenAI-compatible /v1/responses，支持 file_id 解引用、reasoning 控制、请求字段和示例。
- [Responses API](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/endpoints/responses): OpenAI-compatible /v1/responses，支援 file_id 解引用、reasoning 控制、請求欄位和範例。
- [Responses API](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/endpoints/responses): OpenAI-compatible /v1/responses。file_id dereference、reasoning controls、request fields。
- [Search](https://lazu-next-docs-dev.jiaxicui446.workers.dev/endpoints/search): Provider-neutral POST /v1/search for web and news retrieval through configured Lazu search backends.
- [Search](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/endpoints/search): 通过 Lazu Search Backend 调用 provider-neutral 的 POST /v1/search。
- [Search](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/endpoints/search): 透過 Lazu search backends 呼叫 provider-neutral 的 POST /v1/search。
- [Search](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/endpoints/search): configured Lazu search backends を通じた provider-neutral POST /v1/search。
- [Request details](https://lazu-next-docs-dev.jiaxicui446.workers.dev/endpoints/usage-requests): GET /api/usage/requests/{request_id} returns normalized usage, billing, provider usage and routing metadata for one request.
- [请求详情](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/endpoints/usage-requests): GET /api/usage/requests/{request_id} 查询单次请求的 usage、计费、provider raw usage 和 routing metadata。
- [請求詳情](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/endpoints/usage-requests): GET /api/usage/requests/{request_id} 查詢單次請求的 usage、計費、provider raw usage 和 routing metadata。
- [リクエスト詳細](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/endpoints/usage-requests): GET /api/usage/requests/{request_id} は単一 request の usage、billing、provider usage、routing metadata を返します。
- [Errors](https://lazu-next-docs-dev.jiaxicui446.workers.dev/errors): How to read Lazu error responses, common codes you'll hit, and what to do about each.
- [错误码](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/errors): 如何读取 Lazu 错误响应、常见错误码以及对应处理方式。
- [錯誤碼](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/errors): 如何讀取 Lazu 錯誤回應、常見錯誤碼以及對應處理方式。
- [エラーコード](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/errors): Lazu のエラーレスポンス、一般的な code、対応方法。
- [Rate limits](https://lazu-next-docs-dev.jiaxicui446.workers.dev/limits): Lazu enforces tier, unverified-account, and per-key RPM/TPM caps.
- [请求频率限制](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/limits): Lazu 同时执行账号层级、未验证账号和单个 API Key 的 RPM/TPM 限制。
- [請求頻率限制](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/limits): Lazu 同時執行帳號層級、未驗證帳號和單一 API Key 的 RPM/TPM 限制。
- [レート制限](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/limits): Lazu はアカウント tier、未認証アカウント、API Key 単位の RPM/TPM 制限を適用します。
- [Model catalog](https://lazu-next-docs-dev.jiaxicui446.workers.dev/models/catalog): Discover available models and their capabilities at runtime via /api/models/catalog.
- [模型目录](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/models/catalog): 通过 /api/models/catalog 在运行时发现当前 API Key 可用的模型和能力。
- [模型目錄](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/models/catalog): 透過 /api/models/catalog 在執行時發現目前 API Key 可用的模型與能力。
- [モデルカタログ](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/models/catalog): /api/models/catalog で、現在の API Key が利用できるモデルと機能を実行時に検出する。
- [Pricing & lanes](https://lazu-next-docs-dev.jiaxicui446.workers.dev/models/pricing): Lazu offers two routing lanes — direct and cheap — with transparent per-lane pricing and an official reference price for every model.
- [定价与渠道](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/models/pricing): Lazu 的 direct 和 cheap 两种 routing lane，以及如何读取当前 API Key 的有效价格。
- [定價與通道](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/models/pricing): Lazu 的 direct 和 cheap 兩種 routing lane，以及如何讀取目前 API Key 的有效價格。
- [料金と経路](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/models/pricing): Lazu の direct / cheap routing lane と、現在の API Key の有効価格を読む方法。
- [Quickstart](https://lazu-next-docs-dev.jiaxicui446.workers.dev/quickstart): Make your first Lazu API call in under 60 seconds with cURL, Python or TypeScript.
- [快速开始](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh/quickstart): 用 cURL、Python 或 TypeScript 在一分钟内完成第一次 Lazu API 调用。
- [快速開始](https://lazu-next-docs-dev.jiaxicui446.workers.dev/zh-TW/quickstart): 用 cURL、Python 或 TypeScript 在一分鐘內完成第一次 Lazu API 呼叫。
- [クイックスタート](https://lazu-next-docs-dev.jiaxicui446.workers.dev/ja/quickstart): cURL、Python、TypeScript で 60 秒以内に最初の Lazu API 呼び出しを行う。