From 3909e873cf8d93ee71a17816f81340da67f5accc Mon Sep 17 00:00:00 2001 From: api-gateway Date: Thu, 24 Sep 2026 10:00:54 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E5=85=8D=E8=B4=B9=E6=A8=A1=E5=9E=8B?= =?UTF-8?q?=E5=9C=A8=E5=89=8D=E7=AB=AF=E3=80=8C=E6=A8=A1=E5=9E=8B=E4=B8=8E?= =?UTF-8?q?=E4=BE=9B=E5=BA=94=E5=95=86=E3=80=8D=E9=A1=B5=E5=8F=AF=E8=A7=81?= =?UTF-8?q?=EF=BC=88free=20=E5=AD=97=E6=AE=B5=20+=20=E7=BB=BF=E8=89=B2?= =?UTF-8?q?=E3=80=8C=E5=85=8D=E8=B4=B9=E3=80=8D=E6=A0=87=E7=AD=BE=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 后端: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:免费模型说明补「三处标注」口径 --- README.md | 3 ++- app/config.py | 9 +++++++++ app/main.py | 5 +++++ data/gateway.yaml | 1 + frontend/src/locales/en.ts | 2 ++ frontend/src/locales/zh.ts | 2 ++ frontend/src/views/Models.vue | 13 ++++++++++++- tests/test_gateway.py | 14 ++++++++++++++ 8 files changed, 47 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index de4769e..04f834e 100644 --- a/README.md +++ b/README.md @@ -75,7 +75,8 @@ api-gateway/ > 收录 **35 个**模型(2026-09-21 按上游 `GET /models` + 官方文档表刷新,每条线的可用性都真实调用验过): > > - ⭐ **免费**:`space-bunny-free`(Space Bunny Free)—— 官方价格表标 Free / Free / Free、 -> 额度 Unlimited(限时);网关里 `display_name` 带「(免费)」标注,模型页一眼能认出来。 +> 额度 Unlimited(限时)。三处都标注了:配置里 `free: true`、`/v1/models` 带 `free` 字段、 +> 前端「模型与供应商」页在「能力」列打绿色「免费」标签(`display_name` 也带「(免费)」)。 > - `chat/completions` 线:`glm-5.3-flash`、`glm-5.3`、`glm-5.2`、`glm-5.1`、`kimi-k2.7-code`、 > `kimi-k2.6`、`longcat-2.0`、`mimo-v2.5`、`mimo-v2.5-pro`、`mimo-v2.6-flash`、`mimo-v2.6-pro`、 > `omen-alpha`、`hy4-preview`、`hy3` diff --git a/app/config.py b/app/config.py index 7d2c19c..53b314a 100644 --- a/app/config.py +++ b/app/config.py @@ -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( diff --git a/app/main.py b/app/main.py index f24b2fc..804fb9b 100644 --- a/app/main.py +++ b/app/main.py @@ -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}) diff --git a/data/gateway.yaml b/data/gateway.yaml index e89d901..03b31aa 100644 --- a/data/gateway.yaml +++ b/data/gateway.yaml @@ -174,6 +174,7 @@ providers: - id: "space-bunny-free" display_name: "Space Bunny Free(免费)" type: "text" + free: true # 前端「能力」列据此打「免费」标签;/v1/models 也会带出 free 字段 # ★ 免费模型:官方文档价格表 Free / Free / Free,额度 Unlimited(限时)。 # 接替已下线的 union-alpha(Union Alpha Free)。 # 实测 chat 200、messages 200、responses 503 → 标两条线。 diff --git a/frontend/src/locales/en.ts b/frontend/src/locales/en.ts index 6bf0dcb..dc57a70 100644 --- a/frontend/src/locales/en.ts +++ b/frontend/src/locales/en.ts @@ -381,6 +381,8 @@ export default { loadErr: 'Failed to load models', capability: 'Capability', visionTag: 'Vision', + freeTag: 'Free', + freeHint: 'Officially free model: no token billing (quota is set by the vendor; only Space Bunny Free in the current OpenCode Go plan)', paramTag: 'Params locked', paramLocked: 'Parameters pinned by the gateway: {p} (upstream hard limit; values from clients and the speed test are overridden)', allTextModels: 'All text models', diff --git a/frontend/src/locales/zh.ts b/frontend/src/locales/zh.ts index f2c6596..0dfd7be 100644 --- a/frontend/src/locales/zh.ts +++ b/frontend/src/locales/zh.ts @@ -381,6 +381,8 @@ export default { loadErr: '加载模型失败', capability: '能力', visionTag: '视觉', + freeTag: '免费', + freeHint: '官方免费模型:不按 token 计费(额度以官方为准;当前 OpenCode Go 计划里只有 Space Bunny Free)', paramTag: '参数固定', paramLocked: '该模型参数由网关固定:{p}(上游硬约束,客户端与测速探针传的值都会被覆盖)', allTextModels: '全部文本模型', diff --git a/frontend/src/views/Models.vue b/frontend/src/views/Models.vue index 8098a8b..0fb9be6 100644 --- a/frontend/src/views/Models.vue +++ b/frontend/src/views/Models.vue @@ -33,6 +33,8 @@ + + {{ m.id }} + + {{ t('models.freeTag') }} + {{ t('models.paramTag') }} - — + — @@ -374,6 +380,8 @@ const textModelRows = computed(() => id: m.id, provider: m.provider_name || '—', vision: !!m.vision, + // 免费模型(2026-09-21):与表格「能力」列同一份数据 + free: !!m.free, // 模型级强制参数(第二十五轮):被上游固定住的采样参数,用挂锁标注出来。 paramNote: paramKeys(m).length ? paramNote(m) : '', // 支持的格式(第二十七轮):悬浮这一行就能看到「能用哪几条线 + 本次测速走的哪条」 @@ -454,6 +462,9 @@ onMounted(load) .arrow { color: var(--muted-2); } .vision { color: var(--primary); } .plock { color: var(--warn); } +/* 免费模型:绿色系,跟「视觉」(主题色) / 「参数固定」(橙) 区分开 */ +.free-ico { color: #059669; } +.pill.free { background: rgba(16, 185, 129, 0.14); color: #059669; } /* 支持的格式:三条线是并列关系(没有谁更优),统一用主题色弱底, 不用 ok/warn/err —— 否则「messages」看起来像警告、「responses」像被禁用。 */ .proto { diff --git a/tests/test_gateway.py b/tests/test_gateway.py index a260843..578a59c 100644 --- a/tests/test_gateway.py +++ b/tests/test_gateway.py @@ -1667,6 +1667,20 @@ def test_models_endpoint_objects_are_all_model(): assert all("created" in x and "owned_by" in x for x in j["data"]), j["data"][0] +def test_models_payload_marks_free_models(): + """2026-09-21: 免费模型要在 /v1/models 里带 free=true(前端「能力」列据此打「免费」标签)。""" + from fastapi.testclient import TestClient + import app.main as m + client = TestClient(m.app) + data = client.get("/v1/models").json()["data"] + free_ids = [x["id"] for x in data if x.get("free")] + assert "space-bunny-free" in free_ids, f"免费模型没标出来:{free_ids}" + # 反向:付费模型必须是 free=false(不能因为字段缺失而误标) + paid = next(x for x in data if x["id"] == "deepseek-v4.1-flash") + assert paid["free"] is False, paid + assert all("free" in x for x in data), "每个模型都要带 free 字段(缺字段=前端标签会闪)" + + def test_empty_messages_rejected_and_stream_strict(): """P2: 空 messages / 拼错的 stream 类型应在入参处被拒(而非打到上游变 502)。""" from fastapi.testclient import TestClient