docs(readme): 同步2026-09-05全部变更——供应商去协议/记账分流usages/媒体转换铁律/异步执行器/API文档端点

This commit is contained in:
yumoqing 2026-09-05 16:10:47 +08:00
parent 1ccb58c5a7
commit 5ec2ca8fa4

View File

@ -16,14 +16,14 @@
| 表 | 说明 |
|---|---|
| `llm_vendor` | 供应商(协议 + 端点目录 JSON |
| `llm_account` | 供应商账号(钱包:余额/充值/选端点api_key AES 加密) |
| `llm_model` | 模型注册(能力分类/挂定价 ppidname 唯一2026-09 起不存单价,定价走 ppid |
| `llm_api_profile` | 适配模板(协议×能力形态去重) |
| `llm_org_policy` | 组织容错策略(主备模型 + 端点偏好) |
| `llm_vendor` | 供应商(端点目录 JSON2026-09-05 起不存协议字段,请求形态归模型挂的适配模板 |
| `llm_account` | 供应商账号(钱包:余额/充值/选端点api_key AES 加密;模型可绑定账号 account_id 收窄候选池 |
| `llm_model` | 模型注册(能力分类/挂定价 ppid/sync_mode/query_profile_idsname 唯一2026-09 起不存单价,定价走 ppid |
| `llm_api_profile` | 适配模板(协议×能力形态去重data/response 模板全 Jinja2含媒体转换函数 |
| `llm_org_policy` | 组织容错策略(主备模型 + 辅助模型 utility_model_id + 端点偏好) |
| `llm_org_quota` | 组织限额限流(池余额 + QPM |
| `llm_user_quota` | 个人限额限流(额度上限 + QPM |
| `llm_usage` | 用量流水(双维度记账事实表) |
| `llm_usage` | 用量流水(双维度记账事实表usages 字段存非 token 计价因子 JSON |
## 调用门禁链
@ -60,9 +60,24 @@
- **限流用 Redis 分钟窗口原子计数**db4与会话 db3 隔离Redis 故障时限流放行fail-open
余额仍由 DB 条件 UPDATE 守住。
- **429 → (账号,端点)对冷却 60s**;账号级冷却用 `*` 通配键。
- **双维度记账**:一次调用同行记 `cost`(成本侧,账号余额扣)+ `charge`(消费侧,组织池扣);
充值是 `status=recharge` 行(对账用)。
- **预授权-结算**:调用前按预估冻结,调用后按实际 token 多退少补。
- **记账分流2026-09-04 起)**:模型表不存单价,成本/售价统一走 ppid 定价引擎;
调用时流水记 `usages`(非 token 计价因子:视频时长/分辨率等),异步出账循环
accounting.py独立进程经产品层出三方账客户付/商户营收/供应商成本)。
本机构模型流水 `na`owner 模型跨机构调用流水 `pending` 待出账。
- **媒体转换铁律2026-09-05**:生成类模型适配模板 data 用
`b64media2url(request, xxx_file)`(上传转公网 URL、response 用
`downloadfile2url(request, url)`(生成物落地本地,上游 URL 仅 24 小时);
同类能力对外契约统一i2vimage_file 进 → video 出)。
- **异步模型执行器**sync_mode=async 时走提交→按 query_profile_ids 轮询→
取结果;等待预算默认 600 秒,`_timeout` 可覆盖(上限 900
## API 文档端点2026-09-05
`/pipeline-llm/api/v1/docs/`RBAC 授权 any公开文档照 sage /bricks/docs 先例):
- `index.ui``_lang` 参数分发 ApiDoc 组件zh/en/ja/ko 四语言,带白名单回落 zh
- `api_{zh,en,ja,ko}.md` 四语言文档chat/completions + models 端点、异步模型参数、
媒体转换约定、token 认证、计费说明)
- 依赖宿主 conf/config.json 的 processors 注册 `[".md","md"]`MarkdownProcessor
## 文档