# 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.ai/docs
- API Explorer: https://lazu.ai/docs/api-reference
- OpenAPI JSON: https://lazu.ai/docs/openapi.json
- Full LLM context: https://lazu.ai/docs/llms-full.txt

## Documentation pages

- [One API key for Claude, GPT, Gemini and DeepSeek](https://lazu.ai/docs): Lazu API documentation: one OpenAI-compatible key for every model in the catalog — quickstart, endpoints, pricing lanes, errors and request receipts.
- [一个 API Key 调用 Claude、GPT、Gemini、DeepSeek](https://lazu.ai/docs/zh/): Lazu API 文档：一个 OpenAI 兼容的 Key 调用目录里的所有模型——快速开始、接口、定价线路、错误码与请求回执。
- [一把 API Key 呼叫 Claude、GPT、Gemini、DeepSeek](https://lazu.ai/docs/zh-TW/): Lazu API 文件：一把 OpenAI 相容的 Key 呼叫目錄裡的所有模型——快速開始、介面、定價線路、錯誤碼與請求回執。
- [1 つの API キーで Claude・GPT・Gemini・DeepSeek を呼び出す](https://lazu.ai/docs/ja/): Lazu API ドキュメント：1 つの OpenAI 互換キーでカタログ内のすべてのモデルを呼び出す——クイックスタート、エンドポイント、料金、エラー、リクエスト明細。
- [Code examples: cURL, Python and JavaScript for the Lazu API](https://lazu.ai/docs/examples): Lazu API examples for cURL, Python, JavaScript and production troubleshooting.
- [代码示例：Lazu API 的 cURL、Python、JavaScript](https://lazu.ai/docs/zh/examples): Lazu API 的 cURL、Python、JavaScript 和生产排障示例。
- [程式碼範例：Lazu API 的 cURL、Python、JavaScript](https://lazu.ai/docs/zh-TW/examples): Lazu API 的 cURL、Python、JavaScript 與生產排障範例。
- [コードサンプル：Lazu API の cURL・Python・JavaScript](https://lazu.ai/docs/ja/examples): Lazu API の cURL、Python、JavaScript、本番トラブルシューティングのサンプル。
- [API Explorer: send live Lazu API requests](https://lazu.ai/docs/api-reference): Try the Lazu API live — pick an operation, paste your key, send a real request from the docs.
- [API Explorer：在线调用 Lazu API](https://lazu.ai/docs/zh/api-reference): 在线试用 Lazu API —— 选择操作、粘贴密钥、直接发起真实请求。
- [API Explorer：線上呼叫 Lazu API](https://lazu.ai/docs/zh-TW/api-reference): 線上試用 Lazu API —— 選擇操作、貼上金鑰、直接發出真實請求。
- [API Explorer：Lazu API をライブで呼び出す](https://lazu.ai/docs/ja/api-reference): Lazu API をライブで試す —— 操作を選び、キーを貼り付けて、本物のリクエストを送信。
- [Changelog: Lazu API, model and docs updates](https://lazu.ai/docs/changelog): What changed in the Lazu API, the model catalog and these docs, newest first: new models, endpoints, pricing lanes and fixes.
- [更新日志：Lazu API、模型与文档更新](https://lazu.ai/docs/zh/changelog): Lazu API、模型目录和文档的更新记录，按时间倒序：新模型上线、新接口、线路价格调整和问题修复。
- [更新日誌：Lazu API、模型與文件更新](https://lazu.ai/docs/zh-TW/changelog): Lazu API、模型目錄和文件的更新記錄，依時間倒序：新模型上線、新介面、線路價格調整和問題修正。
- [更新履歴：Lazu API・モデル・ドキュメントの更新](https://lazu.ai/docs/ja/changelog): Lazu API、モデルカタログ、ドキュメントの変更を新しい順に掲載：新モデル、新しいエンドポイント、ライン料金の変更、修正。
- [Agent session costs: reconcile a task with its receipts](https://lazu.ai/docs/agent-session-costs): Check the full cost of a coding-agent session, cached tokens and fair official-price comparisons.
- [Agent 会话费用：从一次任务核对到请求回执](https://lazu.ai/docs/zh/agent-session-costs): 核对编程 Agent 会话的完整费用、缓存计费和官方价格比较，避免用部分明细推算全程。
- [Agent 工作階段費用：從任務核對到請求明細](https://lazu.ai/docs/zh-TW/agent-session-costs): 核對程式代理的完整費用、快取計費及官方價格比較，避免以部分明細推算全程。
- [Agent セッションの費用を明細と照合する](https://lazu.ai/docs/ja/agent-session-costs): コーディングエージェントの請求、キャッシュ料金、公式価格との比較範囲を確認します。
- [Authentication: one API key for OpenAI, Anthropic and Gemini formats](https://lazu.ai/docs/authentication): How to authenticate to Lazu with one API key: the OpenAI-compatible Authorization header, the Anthropic x-api-key header, and Gemini native headers, plus storage and rotation.
- [鉴权：一个 API Key 通用 OpenAI、Anthropic、Gemini 格式](https://lazu.ai/docs/zh/authentication): Lazu 的 API Key 怎么用：OpenAI 兼容的 Authorization 请求头、Anthropic 的 x-api-key、Gemini 原生请求头，以及 Key 的保存和轮换。
- [認證：一把 API Key 通用 OpenAI、Anthropic、Gemini 格式](https://lazu.ai/docs/zh-TW/authentication): Lazu 的 API Key 怎麼用：相容 OpenAI 的 Authorization 標頭、Anthropic 的 x-api-key、Gemini 原生標頭，以及 Key 的保存和輪換。
- [認証：1 つの API キーで OpenAI・Anthropic・Gemini 形式に対応](https://lazu.ai/docs/ja/authentication): Lazu の API キーの使い方：OpenAI 互換の Authorization ヘッダー、Anthropic の x-api-key、Gemini ネイティブのヘッダー、キーの保管とローテーション。
- [Billing: prepaid balance, token prices and request receipts](https://lazu.ai/docs/billing): How Lazu bills each request: a prepaid USD balance, per-million-token prices by lane, separate cache, audio and image dimensions, and how to reconcile a charge with its receipt.
- [计费说明：预付余额、token 价格与请求回执](https://lazu.ai/docs/zh/billing): Lazu 每次请求怎么计费：美元预付余额、按线路的每百万 token 价格、缓存/音频/图片单独计价，以及怎么用请求回执对账。
- [計費說明：預付餘額、token 價格與請求回執](https://lazu.ai/docs/zh-TW/billing): Lazu 每次請求怎麼計費：美元預付餘額、依線路的每百萬 token 價格、快取/音訊/圖片分開計價，以及怎麼用請求回執對帳。
- [料金体系：前払い残高、トークン料金、リクエストの明細](https://lazu.ai/docs/ja/billing): Lazu のリクエストごとの課金：米ドルの前払い残高、ライン別の 100 万トークンあたり料金、キャッシュ・音声・画像の個別料金、明細での照合方法。
- [Chat completions API (OpenAI-compatible)](https://lazu.ai/docs/endpoints/chat): OpenAI-compatible /v1/chat/completions with inline parameters, examples, streaming, tools and cache usage notes.
- [Chat Completions API（OpenAI 兼容）](https://lazu.ai/docs/zh/endpoints/chat): OpenAI 兼容的 /v1/chat/completions，同页包含参数、示例、流式、工具调用和 cache usage 字段。
- [Chat Completions API（相容 OpenAI）](https://lazu.ai/docs/zh-TW/endpoints/chat): OpenAI-compatible /v1/chat/completions，包含參數、stream、tools、usage 和 cache 欄位。
- [Chat Completions API（OpenAI 互換）](https://lazu.ai/docs/ja/endpoints/chat): OpenAI-compatible /v1/chat/completions。parameters、stream、tools、usage/cache fields。
- [Decisions](https://lazu.ai/docs/endpoints/decisions): Evaluate probability, choice and score questions with Jev and multimodal Clef models.
- [判别模型](https://lazu.ai/docs/zh/endpoints/decisions): 判别模型: Jev, Clef, Clef Flash
- [判別模型](https://lazu.ai/docs/zh-TW/endpoints/decisions): 判別模型: Jev, Clef, Clef Flash
- [判別モデル](https://lazu.ai/docs/ja/endpoints/decisions): 判別モデル: Jev, Clef, Clef Flash
- [Embeddings API (OpenAI-compatible)](https://lazu.ai/docs/endpoints/embeddings): OpenAI-compatible /v1/embeddings with request fields, batch inputs, dimensions and examples.
- [Embeddings 向量 API（OpenAI 兼容）](https://lazu.ai/docs/zh/endpoints/embeddings): OpenAI-compatible /v1/embeddings，请求字段、批量输入、维度和响应说明。
- [Embeddings 向量 API（相容 OpenAI）](https://lazu.ai/docs/zh-TW/endpoints/embeddings): OpenAI-compatible /v1/embeddings，請求欄位、批次輸入、維度和響應說明。
- [Embeddings API（OpenAI 互換）](https://lazu.ai/docs/ja/endpoints/embeddings): OpenAI-compatible /v1/embeddings。request fields、batch inputs、dimensions。
- [Files API: upload PDFs and images for the Responses API](https://lazu.ai/docs/endpoints/files): Upload PDFs, images and documents, then reference file_id values from the Responses API.
- [Files API：上传 PDF 和图片给 Responses API 使用](https://lazu.ai/docs/zh/endpoints/files): 上传 PDF、图片和文档，然后在 Responses API 中通过 file_id 引用。
- [Files API：上傳 PDF 和圖片給 Responses API 使用](https://lazu.ai/docs/zh-TW/endpoints/files): 上傳 PDF、圖片和文件，然後在 Responses API 中透過 file_id 引用。
- [Files API：Responses API 用に PDF・画像をアップロード](https://lazu.ai/docs/ja/endpoints/files): PDF、画像、documents を upload し、Responses API から file_id で参照する。
- [Image, video and audio generation API](https://lazu.ai/docs/endpoints/media): Generate images, submit and poll video jobs, and create or transcribe speech through Lazu with the same API key: request fields, results and errors.
- [图片、视频与音频生成 API](https://lazu.ai/docs/zh/endpoints/media): 用同一个 API Key 在 Lazu 上生成图片、提交并轮询视频任务、合成或转写语音：请求字段、返回结果和错误处理。
- [圖片、影片與音訊生成 API](https://lazu.ai/docs/zh-TW/endpoints/media): 用同一把 API Key 在 Lazu 上生成圖片、提交並輪詢影片任務、合成或轉寫語音：請求欄位、回傳結果和錯誤處理。
- [画像・動画・音声の生成 API](https://lazu.ai/docs/ja/endpoints/media): 同じ API キーで画像を生成し、動画ジョブを送信・ポーリングし、音声を合成・文字起こしできます。リクエスト項目、結果、エラーを解説します。
- [Models list API: GET /v1/models](https://lazu.ai/docs/endpoints/models): OpenAI-compatible /v1/models plus guidance on when to use the richer /api/models/catalog.
- [模型列表 API：GET /v1/models](https://lazu.ai/docs/zh/endpoints/models): OpenAI-compatible /v1/models，以及什么时候应该改用更完整的 /api/models/catalog。
- [模型列表 API：GET /v1/models](https://lazu.ai/docs/zh-TW/endpoints/models): OpenAI-compatible /v1/models，以及什麼時候應該改用更完整的 /api/models/catalog。
- [モデル一覧 API：GET /v1/models](https://lazu.ai/docs/ja/endpoints/models): OpenAI-compatible /v1/models と、より詳しい /api/models/catalog を使うべき場面。
- [Responses API (OpenAI-compatible)](https://lazu.ai/docs/endpoints/responses): OpenAI-compatible /v1/responses with file_id dereferencing, reasoning controls, request fields and examples.
- [Responses API（OpenAI 兼容）](https://lazu.ai/docs/zh/endpoints/responses): OpenAI-compatible /v1/responses，支持 file_id 解引用、reasoning 控制、请求字段和示例。
- [Responses API（相容 OpenAI）](https://lazu.ai/docs/zh-TW/endpoints/responses): OpenAI-compatible /v1/responses，支援 file_id 解引用、reasoning 控制、請求欄位和範例。
- [Responses API（OpenAI 互換）](https://lazu.ai/docs/ja/endpoints/responses): OpenAI-compatible /v1/responses。file_id dereference、reasoning controls、request fields。
- [Search API: web and news retrieval](https://lazu.ai/docs/endpoints/search): Provider-neutral POST /v1/search for web and news retrieval through configured Lazu search backends.
- [Search API：网页与新闻检索](https://lazu.ai/docs/zh/endpoints/search): 通过 Lazu Search Backend 调用 provider-neutral 的 POST /v1/search。
- [Search API：網頁與新聞檢索](https://lazu.ai/docs/zh-TW/endpoints/search): 透過 Lazu search backends 呼叫 provider-neutral 的 POST /v1/search。
- [Search API：Web とニュースの検索](https://lazu.ai/docs/ja/endpoints/search): configured Lazu search backends を通じた provider-neutral POST /v1/search。
- [Request details API: usage, charge and timing per request](https://lazu.ai/docs/endpoints/usage-requests): Look up a single request by its ID: normalized token usage, the customer charge, cache fields and public timing.
- [请求详情 API：单次请求的用量、费用与耗时](https://lazu.ai/docs/zh/endpoints/usage-requests): 按请求 ID 查询单次请求：标准化的 token 用量、实际扣费、缓存字段和公开耗时。
- [請求詳情 API：單次請求的用量、費用與耗時](https://lazu.ai/docs/zh-TW/endpoints/usage-requests): 依請求 ID 查詢單次請求：標準化的 token 用量、實際扣費、快取欄位和公開耗時。
- [リクエスト詳細 API：1 件ごとの使用量・料金・所要時間](https://lazu.ai/docs/ja/endpoints/usage-requests): リクエスト ID で 1 件のリクエストを照会：正規化されたトークン使用量、実際の請求額、キャッシュ項目、公開タイミング。
- [Error codes: what each Lazu API error means](https://lazu.ai/docs/errors): How to read Lazu error responses, what every error number means, and what to do about each.
- [错误码：Lazu API 每个错误的含义与处理](https://lazu.ai/docs/zh/errors): 如何读取 Lazu 错误响应、每个错误编号的含义以及对应处理方式。
- [錯誤碼：Lazu API 每個錯誤的含義與處理](https://lazu.ai/docs/zh-TW/errors): 如何讀取 Lazu 錯誤回應、每個錯誤編號的含義以及對應處理方式。
- [エラーコード：Lazu API の各エラーの意味と対処](https://lazu.ai/docs/ja/errors): Lazu のエラーレスポンスの読み方、各エラー番号の意味と対処方法。
- [Handling request errors: retries, timeouts and limits](https://lazu.ai/docs/limits): How to handle Lazu API request errors in production: which failures to retry, backoff, timeouts, rate limits and interrupted streams.
- [请求错误处理：重试、超时与限流](https://lazu.ai/docs/zh/limits): 生产环境里怎么处理 Lazu API 的请求错误：哪些失败该重试、退避、超时、限流和流式中断。
- [請求錯誤處理：重試、逾時與限流](https://lazu.ai/docs/zh-TW/limits): 正式環境裡怎麼處理 Lazu API 的請求錯誤：哪些失敗該重試、退避、逾時、限流和串流中斷。
- [リクエストエラーへの対処：リトライ・タイムアウト・レート制限](https://lazu.ai/docs/ja/limits): 本番環境で Lazu API のリクエストエラーをどう扱うか：リトライすべき失敗、バックオフ、タイムアウト、レート制限、ストリームの中断。
- [Model catalog API: capabilities and prices at runtime](https://lazu.ai/docs/models/catalog): Discover available models and their capabilities at runtime via /api/models/catalog.
- [模型目录 API：运行时读取能力与价格](https://lazu.ai/docs/zh/models/catalog): 通过 /api/models/catalog 在运行时发现当前 API Key 可用的模型和能力。
- [模型目錄 API：執行時讀取能力與價格](https://lazu.ai/docs/zh-TW/models/catalog): 透過 /api/models/catalog 在執行時發現目前 API Key 可用的模型與能力。
- [モデルカタログ API：実行時に機能と料金を取得](https://lazu.ai/docs/ja/models/catalog): /api/models/catalog で、現在の API Key が利用できるモデルと機能を実行時に検出する。
- [Pricing and lanes: stable lane vs discount lane](https://lazu.ai/docs/models/pricing): How Lazu prices each model: the stable lane on official APIs, the discount lane for agent tools such as Claude Code, Codex and Antigravity, per-key lane choice, and how to read live prices.
- [价格与线路：稳定线路和优惠线路的区别](https://lazu.ai/docs/zh/models/pricing): Lazu 每个模型怎么定价：稳定线路走官方 API，优惠线路是逆向渠道、只用于 Claude Code、Codex、Antigravity 等 Agent 工具；每把 Key 按模型选线路，以及怎么读实时价格。
- [價格與線路：穩定線路和優惠線路的差別](https://lazu.ai/docs/zh-TW/models/pricing): Lazu 每個模型怎麼定價：穩定線路走官方 API，優惠線路是逆向渠道、只用於 Claude Code、Codex、Antigravity 等 Agent 工具；每把 Key 依模型選線路，以及怎麼讀即時價格。
- [料金とライン：安定ラインと割引ラインの違い](https://lazu.ai/docs/ja/models/pricing): Lazu の各モデルの料金：安定ラインは公式 API、割引ラインはリバース型の経路で Claude Code・Codex・Antigravity などの Agent ツール専用。キーごとのライン選択とリアルタイム料金の読み方。
- [Quickstart: call Claude, GPT and Gemini with one API key](https://lazu.ai/docs/quickstart): Create a Lazu API key, point any OpenAI SDK at https://api.lazu.ai/v1, and send your first request to Claude, GPT, Gemini or DeepSeek in a few minutes.
- [快速开始：一个 API Key 调用 Claude、GPT、Gemini](https://lazu.ai/docs/zh/quickstart): 创建 Lazu API Key，把任意 OpenAI SDK 的地址改成 https://api.lazu.ai/v1，几分钟内向 Claude、GPT、Gemini 或 DeepSeek 发出第一个请求，国内可直连。
- [快速開始：一把 API Key 呼叫 Claude、GPT、Gemini](https://lazu.ai/docs/zh-TW/quickstart): 建立 Lazu API Key，把任意 OpenAI SDK 的位址改成 https://api.lazu.ai/v1，幾分鐘內向 Claude、GPT、Gemini 或 DeepSeek 發出第一個請求。
- [クイックスタート：1 つの API キーで Claude・GPT・Gemini を呼び出す](https://lazu.ai/docs/ja/quickstart): Lazu の API キーを作成し、任意の OpenAI SDK の接続先を https://api.lazu.ai/v1 に変えるだけで、数分で Claude・GPT・Gemini・DeepSeek に最初のリクエストを送れます。