Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

更新日志

尚未发布 — 账户安全清理

  • 新账户使用邮箱验证码或已启用的第三方登录。用户名/密码注册和 /register 已删除;老用户仍可使用密码登录。
  • 邮箱绑定改为登录后调用 POST /api/user/email/bind/start 和 POST /api/user/email/bind。换绑需验证新旧两个邮箱。旧的 GET /api/verification 和 GET 绑定接口已删除。
  • 删除无实际功能的 POST /api/user/reset;密码重置继续使用 /api/user/reset/v2。
  • 删除 /api/log/token、/api/user/used-models、/api/user/models/classified、/api/user/self/stripe/pay 和 /api/user/stripe/amount。请使用 /api/log/self、模型目录和 /api/user/stripe/pay。
  • 删除从未实现的 /v1/fine-tunes*、/v1/images/variations 和 DELETE /v1/models/:model。以上删除取代此前公告的退役日期,不保留兼容重定向。

2026-11-02 — 用量与日志改版,移除月度报告

  • 控制台“用量与日志”里的“月度报告”标签和它使用的 /api/reports/monthly* 接口已移除,这些接口现在返回 404。月度报告从未发送过邮件或生成 PDF;每月花费请在总览或 API 调用里按 30 天、90 天或自定义时间范围查看。
  • monthly_reports、report_subscriptions 两张表暂时留在数据库里,之后的数据库版本升级时删除。
  • “文件”标签并入“生成任务”:在“生成任务”里选“上传的文件”即可看到通过 /v1/files 上传的文件,下载和删除照旧;旧链接 ?tab=files 会自动跳转过去。生成的图片和视频仍列在各自的任务里。
  • 时间范围移到页头,“API 调用”“Agent 会话”“生成任务”三个页面共用;新增 90 天。“API 调用”顶部改为按天显示花费,并给出请求数、成功率、缓存命中率和首字中位数;失败的请求在行下直接写明原因和处理办法。
  • GET /api/log/self/stat 和 GET /api/log/stat 不再返回 rpm、tpm(它们只统计最近 60 秒,查看历史时总是 0),改为返回所选范围的 request_count、error_count、cache_hit_ratio、median_ttft_ms、按小时的 series,以及上一段同样长的时间的 previous_amount_microusd。

2026-10-29 — 移除搜索接口

  • POST /v1/search 和 /api/search/backends* 已提前于原定的 2026-11-01 移除,下面列出的控制台页面、状态页搜索行和 API 密钥搜索字段也一并移除。这两个接口现在返回 404 endpoint_not_supported(LZ-1010)。
  • 错误码 LZ-7302、LZ-7861、LZ-7862 停用。原来的搜索文档页会跳转到本更新日志。

2026-10-29 — 弃用搜索接口

  • POST /v1/search 及检索后端管理接口(/api/search/backends*)已弃用,2026-11-01 之后的第一个版本将移除。这些接口的响应现在带有 Deprecation、Sunset 头。api.lazu.ai 上没有客户调用过该接口,所以窗口比通常的 90 天短。
  • 一并移除:控制台的“检索后端”页、状态页中的搜索行,以及 API 密钥的 search_limits_enabled、search_providers、search_domain_allowlist 字段。
  • 不受影响:模型自带的联网搜索工具(/v1/responses 和 Chat 上的 web_search、/v1/messages 上的 Claude 联网搜索)照常可用,计费不变。依赖 /v1/search 的自部署用户可以直接调用搜索服务商。

2026-10-26 — 弃用五项自部署设置

  • LogConsumeEnabled=false 已弃用。2027-01-24 之后消费日志将始终写入;如需控制存储,请改用 LOG_RETENTION_DAYS。
  • Worker 下载代理(WorkerUrl、WorkerValidKey、WorkerAllowHttpImageRequestEnabled)已弃用。2027-01-24 之后媒体下载和 webhook 将直接连接,并按媒体抓取策略检查地址。
  • general_setting.quota_display_type=TOKENS 已弃用。2027-01-24 之后日志文本中的金额一律以美元显示,与控制台一致。
  • SETTLEMENT_OUTBOX_ENABLED=true 已弃用。2027-01-24 之后结算 outbox 及其对账任务将移除;结算失败仍由失败对账任务恢复。
  • DataExportEnabled(连同 DataExportInterval)已弃用。2027-02-01 之后按小时汇总的 usage_data 表和 GET /api/data/ 将移除;看板和用量页不读取它们。如需保留,请先导出这张表。
  • 配置了其中任一项的部署,启动时会输出一行 deprecated setting: 提示。详见部署指南的“Deprecated settings”一节。

2026-10-26 — 一批 API 路由计划下线

下列路由现在会返回 Deprecation、Sunset 响应头;有替代接口的,还会返回 Link: <…>; rel="successor-version"。管理接口在 2026-12-01 之后删除,用户接口和公开 API 在 2027-02-01 之后删除。每次删除前都会核对生产访问记录。

  • POST /api/user/self/stripe/pay:改用 POST /api/user/stripe/pay。POST /api/user/stripe/amount:金额由控制台计算。
  • /api/user/used-models、/api/user/models/classified(改用 /api/user/models/catalog)、PUT /api/user/:id/has_topped_up、/api/data/self(改用 /api/data/dashboard/self)、/api/log/token(改用 /api/log/self)、/api/usage/token(改用 /api/usage/summary)、/api/log/self/in_flight(改用 /api/log/self/tasks)、/api/log/self/tasks/:id。
  • Playground 路由 /pg/chat/completions;控制台已没有 Playground。
  • 返回 501 的 /v1/fine-tunes*、/v1/images/variations、DELETE /v1/models/:model,以及余额接口 /v1/dashboard/billing/*、/dashboard/billing/*,由控制台钱包取代。
  • /api/community/* 和 /api/models/rankings。
  • 管理接口(2026-12-01 之后删除):/api/channel/tag/*、/api/channel/batch*(改用逐个渠道操作),POST /api/notification/email/{send,announcement}(改用公告),/api/upload/*(改用 config.yaml 里的定时上传),/api/workers/*,GET /api/data/(它读取的 usage_data 表也已弃用)。

2026-09-30 — Agent 会话、请求回执与长上下文价格

  • 围绕任务、模型和逐请求回执重做 Agent 会话。
  • 增加会话活动视图与子代理线路;展示范围是网关活动,不包含本地工具执行。
  • 将长上下文价格接入成本计算、请求回执与公开模型页;实际阶梯取决于模型与线路配置。
  • sitemap 的修改日期改为真实内容变更时间。

以上日期指源码合并时间,自部署实例是否可用取决于部署版本。可按会话费用核对指南复算导出的明细。

2026-05-28 — Usage 元数据与缓存字段

  • OpenAI-compatible 响应新增标准化缓存字段:cached_tokens、 cache_write_tokens、cache_write_5m_tokens、cache_write_1h_tokens 和 cache_miss_tokens。
  • 模型目录新增 usage_capabilities,调用前即可发现模型可能上报的 usage 维度和可计费维度。
  • 新增 GET /api/usage/requests/{request_id},用于查询单次请求的 usage 维度、账单行项目、provider 原始缓存字段和路由信息。
  • 补充 Qwen/DashScope、DeepSeek、Anthropic、Gemini、OpenAI 和 OpenRouter 的缓存上报差异。

2026-05-12 — 静态文档回到 VPS

  • 恢复 Vocs 作为 docs.lazu.ai 的活跃文档站。
  • 通过独立 nginx 静态容器服务文档。
  • 统一官网和文档里的产品品牌与 API 示例。

2026-05-09 — OpenAPI Reference 整理

  • packages/contracts/openapi/lazu-api-reference.v1.yaml 继续作为事实来源。
  • 构建时同步 OpenAPI JSON/YAML 到 docs public assets。
  • 保留交互式 reference,用于查请求和响应字段。