feat: 免费模型在前端「模型与供应商」页可见(free 字段 + 绿色「免费」标签)

- 后端:ModelInfo 增加 free 字段(yaml models[].free,_opt_bool 校验)、all_models() 带出、
  /v1/models 暴露 free(别名随目标继承,与 vision/params 同源)
- 配置:space-bunny-free 标 free: true(与 display_name 的「(免费)」双保险)
- 前端:Models.vue「能力」列新增绿色「免费」标签(bolt 图标 + 悬浮说明)、测速行同步标一颗闪电;
  i18n 中英各 +2 键(freeTag/freeHint),753/753 对称
- 测试:新增 test_models_payload_marks_free_models(免费模型必须 free=true、付费必须 false、
  每个模型都要带该字段),全套 192 passed / 0 failed
- README:免费模型说明补「三处标注」口径
This commit is contained in:
api-gateway committed 2026-09-24 10:00:54 +08:00
1 parent 3b83dcfc75
commit 7252d97bb6
8 files changed
+47 -2

No files matched your search

+9
View File
@@ -127,6 +127,11 @@ class ModelInfo:
# 其余文本模型(ark-code 等)文档未声明图像输入 → 默认 False。
# 用途:① /v1/models 暴露给前端标注/告警;② 前端据此提示「换个支持视觉的模型」力的模型排到前面。
vision: bool = False
# 2026-09-21: 是否**免费模型**(官方价格表标 Free、不按 token 计费)。
# 纯标注用途:/v1/models 带出 `free` 字段,前端「能力」列打「免费」标签;
# 不参与路由/限流/熔断,也不影响成本估算(额度由上游控制,网关无法感知)。
# 配置写法:`models[]` 里加 `free: true`(OpenCode Go 当前只有 space-bunny-free)。
free: bool = False
# 第二十五轮(模型参数硬约束): 该模型**必须用**的上游参数,发送前强制覆盖客户端传值。
# 背景:OpenCode Go 的 kimi-k2.7-code 只接受 temperature=1,客户端传 0(含一键测速的
# 探针,它固定发 temperature=0)会被上游 400:
@@ -384,6 +389,9 @@ class GatewayConfig:
"display_name": m.display_name or m.id,
"type": m.type,
"vision": m.vision,
# 2026-09-21: 免费模型标注(官方标 Free)。前端「能力」列打「免费」标签,
# /v1/models 也带出该字段;不参与路由/限流/计费。
"free": bool(m.free),
"provider": pkey,
"provider_name": pconfig.name,
# 第二十五轮: 暴露模型级强制参数(如 {"temperature": 1})。
@@ -774,6 +782,7 @@ def parse_config(raw: dict[str, Any]) -> GatewayConfig:
models = [
ModelInfo(id=m.get("id", ""), display_name=m.get("display_name", ""),
type=m.get("type", "text"), vision=_opt_bool(m.get("vision"), "providers.*.models.*.vision", False),
free=_opt_bool(m.get("free"), "providers.*.models.*.free", False),
params=_parse_model_params(
m.get("params"), f"providers.{pkey}.models[{idx}].params"),
protocols=_parse_protocols(
+5
View File
@@ -1224,6 +1224,9 @@ def _models_payload():
"type": m["type"], "provider": m["provider"], "provider_name": m["provider_name"],
# 第十三轮: 暴露「是否支持图像输入」,前端据此标注/告警(对话页带图时提示换模型)
"vision": bool(m.get("vision")),
# 2026-09-21: 免费模型标注(官方标 Free)—— 前端「能力」列据此打「免费」标签,
# 接口调用方也能提前知道这个模型不计费。
"free": bool(m.get("free")),
# 第二十五轮: 暴露模型级强制参数(如 {"temperature": 1})。前端据此标挂锁,
# API 调用方也能提前知道自己传的采样参数会被上游要求覆盖。
"params": dict(m.get("params") or {}),
@@ -1251,6 +1254,8 @@ def _models_payload():
"display_name": aminfo.display_name,
"type": aminfo.type, "provider": apkey, "provider_name": apconfig.name,
"vision": bool(aminfo.vision),
# 2026-09-21: 免费位随目标继承(与 vision / params 同一份事实来源)
"free": bool(aminfo.free),
"params": dict(aminfo.params or {}),
"protocols": list(ALIAS_PROTOCOLS),
"alias_of": aminfo.id, "alias_note": spec.note})