API 约定

• 请求按对应 API/wire family 同 wire 转发，并由内部调用入口选择模型商品和上游，不做跨协议转换。
• 用户 API Key 与上游 provider Key 严格分离。
• public model id 按内部调用入口发布；不能跨列表推断可用性。
• 已声明路径同时支持有、无尾随 /。
• 模型列表不扣费、不写 usage，也不代表上游实时健康。
• 调用前账户余额扣除在途请求预留金额后的可用余额必须大于 0；结算后账户余额允许变负。
• 错误响应尽量返回稳定错误码和 request_id；Gemini 使用 Google 风格错误结构。
• token 商品的合法 JSON 对象，或已经交付至少一个上游/model chunk 的 stream，在 usage 缺失/无效时只允许保守下限估算；图片按实际有效图片计费。
• 站内图生图使用网页登录态 /api/img/edits，不开放公开 /v1/images/edits。

更详细的 API family、调用入口和字段以 API 概览 为入口。