更新日志
尚未发布 — 账户安全清理
- 新账户使用邮箱验证码或已启用的第三方登录。用户名/密码注册和
/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 密钥搜索字段也一并移除。这两个接口现在返回 404endpoint_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,用于查请求和响应字段。