lsy
512a1fa45e
- 抽取 reasoning_effort 解析并复用 - /v1/responses 400/404 时回退 /responses - 记录实际请求路径用于 usage 统计 - 更新相关文档与 dev 脚本
23 lines
725 B
Markdown
23 lines
725 B
Markdown
# proxy 模块
|
|
|
|
## 职责
|
|
- 提供 OpenAI 兼容 API 代理
|
|
- 根据权重选择渠道并支持故障回退
|
|
- 记录用量日志并回写额度
|
|
|
|
## 接口定义
|
|
- `/v1/*` OpenAI 兼容代理路径
|
|
|
|
## 行为规范
|
|
- 基于令牌鉴权
|
|
- 按渠道权重随机排序
|
|
- 支持从非流式 JSON、响应头与流式 SSE 解析 usage 字段
|
|
- 流式请求自动补 `stream_options.include_usage=true` 以便上游返回 usage
|
|
- 对 `/v1/responses` 且上游返回 400/404 时回退为 `/responses` 重试一次
|
|
- 可配置失败重试轮询（响应 5xx/429 时触发）
|
|
- 记录流式请求标记、首 token 延迟与推理强度到 usage_logs
|
|
|
|
## 依赖关系
|
|
- `channels` / `tokens` / `usage_logs` 表
|
|
- `tokenAuth` 中间件
|