定价与渠道
Lazu 在模型页展示三类价格：
- 官方参考价：上游 provider 公布价格，仅用于对比。
- direct lane 价格：通过官方或一方云路径路由时的价格。
- cheap lane 价格：通过更低成本路径路由时的价格，适合实验、批处理和成本敏感场景。
direct 和 cheap 的区别
| Lane | 路由到哪里 | 适合场景 |
|---|---|---|
direct | 官方 endpoint 或主流云：Azure / AWS / GCP | 生产、合规、延迟敏感 workload |
cheap | 更低成本的第三方路径 | 批处理、实验、原型、成本敏感任务 |
每个模型至少有 direct lane。cheap 按模型和 vendor 单独启用；不是所有模型都有。
按 vendor 设置 lane
在 控制台 -> API Keys 打开一个 key 的 Advanced 设置，可以为每个 vendor 选择：
- direct：该 vendor 的模型总是走 direct lane。
- cheap：优先 cheap；如果请求模型没有 cheap route，则回退到 direct。
如果没有配置，默认偏好是 cheap。
Fallback 行为
如果请求 cheap，但目标模型只有 direct：
- 请求仍返回 HTTP 200
- 响应头包含
X-Lazu-Lane-Fallback: cheap->direct - 按 direct lane 价格计费
如果请求 direct 但没有 direct channel，Lazu 返回 HTTP 404 model_not_found，不会静默降级。
通过 API 读取有效价格
对 agent 和脚本，推荐启动时读取 /api/models/catalog：
curl https://api.lazu.ai/api/models/catalog \
-H "Authorization: Bearer $LAZU_API_KEY" \
| jq '.data[] | select(.id=="gpt-4o-mini") | .pricing'返回的 pricing 已经是当前 API Key 的有效价格，包含它的 lane 偏好和可访问范围。
只有需要公开 list-pricing 视图时才使用 /api/pricing。
价格变更
当上游 provider 调整价格时，Lazu 会更新价格并在 更新日志 说明。实际扣费始终按请求发生时生效的价格计算，不会 retroactively re-bill。