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 68ddccba53
commit 70c82d4ca7
8 files changed
+47 -2

No files matched your search

+2 -1
View File
@@ -75,7 +75,8 @@ api-gateway/
> 收录 **35 个**模型(2026-09-21 按上游 `GET /models` + 官方文档表刷新,每条线的可用性都真实调用验过): > 收录 **35 个**模型(2026-09-21 按上游 `GET /models` + 官方文档表刷新,每条线的可用性都真实调用验过):
> >
> - ⭐ **免费**:`space-bunny-free`(Space Bunny Free)—— 官方价格表标 Free / Free / Free、 > - ⭐ **免费**:`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`、 > - `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`、 > `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` > `omen-alpha`、`hy4-preview`、`hy3`
+9
View File
@@ -127,6 +127,11 @@ class ModelInfo:
# 其余文本模型(ark-code 等)文档未声明图像输入 → 默认 False。 # 其余文本模型(ark-code 等)文档未声明图像输入 → 默认 False。
# 用途:① /v1/models 暴露给前端标注/告警;② 前端据此提示「换个支持视觉的模型」力的模型排到前面。 # 用途:① /v1/models 暴露给前端标注/告警;② 前端据此提示「换个支持视觉的模型」力的模型排到前面。
vision: bool = False 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(含一键测速的 # 背景:OpenCode Go 的 kimi-k2.7-code 只接受 temperature=1,客户端传 0(含一键测速的
# 探针,它固定发 temperature=0)会被上游 400: # 探针,它固定发 temperature=0)会被上游 400:
@@ -384,6 +389,9 @@ class GatewayConfig:
"display_name": m.display_name or m.id, "display_name": m.display_name or m.id,
"type": m.type, "type": m.type,
"vision": m.vision, "vision": m.vision,
# 2026-09-21: 免费模型标注(官方标 Free)。前端「能力」列打「免费」标签,
# /v1/models 也带出该字段;不参与路由/限流/计费。
"free": bool(m.free),
"provider": pkey, "provider": pkey,
"provider_name": pconfig.name, "provider_name": pconfig.name,
# 第二十五轮: 暴露模型级强制参数(如 {"temperature": 1})。 # 第二十五轮: 暴露模型级强制参数(如 {"temperature": 1})。
@@ -774,6 +782,7 @@ def parse_config(raw: dict[str, Any]) -> GatewayConfig:
models = [ models = [
ModelInfo(id=m.get("id", ""), display_name=m.get("display_name", ""), 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), 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( params=_parse_model_params(
m.get("params"), f"providers.{pkey}.models[{idx}].params"), m.get("params"), f"providers.{pkey}.models[{idx}].params"),
protocols=_parse_protocols( protocols=_parse_protocols(
+5
View File
@@ -1224,6 +1224,9 @@ def _models_payload():
"type": m["type"], "provider": m["provider"], "provider_name": m["provider_name"], "type": m["type"], "provider": m["provider"], "provider_name": m["provider_name"],
# 第十三轮: 暴露「是否支持图像输入」,前端据此标注/告警(对话页带图时提示换模型) # 第十三轮: 暴露「是否支持图像输入」,前端据此标注/告警(对话页带图时提示换模型)
"vision": bool(m.get("vision")), "vision": bool(m.get("vision")),
# 2026-09-21: 免费模型标注(官方标 Free)—— 前端「能力」列据此打「免费」标签,
# 接口调用方也能提前知道这个模型不计费。
"free": bool(m.get("free")),
# 第二十五轮: 暴露模型级强制参数(如 {"temperature": 1})。前端据此标挂锁, # 第二十五轮: 暴露模型级强制参数(如 {"temperature": 1})。前端据此标挂锁,
# API 调用方也能提前知道自己传的采样参数会被上游要求覆盖。 # API 调用方也能提前知道自己传的采样参数会被上游要求覆盖。
"params": dict(m.get("params") or {}), "params": dict(m.get("params") or {}),
@@ -1251,6 +1254,8 @@ def _models_payload():
"display_name": aminfo.display_name, "display_name": aminfo.display_name,
"type": aminfo.type, "provider": apkey, "provider_name": apconfig.name, "type": aminfo.type, "provider": apkey, "provider_name": apconfig.name,
"vision": bool(aminfo.vision), "vision": bool(aminfo.vision),
# 2026-09-21: 免费位随目标继承(与 vision / params 同一份事实来源)
"free": bool(aminfo.free),
"params": dict(aminfo.params or {}), "params": dict(aminfo.params or {}),
"protocols": list(ALIAS_PROTOCOLS), "protocols": list(ALIAS_PROTOCOLS),
"alias_of": aminfo.id, "alias_note": spec.note}) "alias_of": aminfo.id, "alias_note": spec.note})
+1
View File
@@ -174,6 +174,7 @@ providers:
- id: "space-bunny-free" - id: "space-bunny-free"
display_name: "Space Bunny Free(免费)" display_name: "Space Bunny Free(免费)"
type: "text" type: "text"
free: true # 前端「能力」列据此打「免费」标签;/v1/models 也会带出 free 字段
# ★ 免费模型:官方文档价格表 Free / Free / Free,额度 Unlimited(限时)。 # ★ 免费模型:官方文档价格表 Free / Free / Free,额度 Unlimited(限时)。
# 接替已下线的 union-alpha(Union Alpha Free)。 # 接替已下线的 union-alpha(Union Alpha Free)。
# 实测 chat 200、messages 200、responses 503 → 标两条线。 # 实测 chat 200、messages 200、responses 503 → 标两条线。
+2
View File
@@ -381,6 +381,8 @@ export default {
loadErr: 'Failed to load models', loadErr: 'Failed to load models',
capability: 'Capability', capability: 'Capability',
visionTag: 'Vision', 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', paramTag: 'Params locked',
paramLocked: 'Parameters pinned by the gateway: {p} (upstream hard limit; values from clients and the speed test are overridden)', paramLocked: 'Parameters pinned by the gateway: {p} (upstream hard limit; values from clients and the speed test are overridden)',
allTextModels: 'All text models', allTextModels: 'All text models',
+2
View File
@@ -381,6 +381,8 @@ export default {
loadErr: '加载模型失败', loadErr: '加载模型失败',
capability: '能力', capability: '能力',
visionTag: '视觉', visionTag: '视觉',
freeTag: '免费',
freeHint: '官方免费模型:不按 token 计费(额度以官方为准;当前 OpenCode Go 计划里只有 Space Bunny Free)',
paramTag: '参数固定', paramTag: '参数固定',
paramLocked: '该模型参数由网关固定:{p}(上游硬约束,客户端与测速探针传的值都会被覆盖)', paramLocked: '该模型参数由网关固定:{p}(上游硬约束,客户端与测速探针传的值都会被覆盖)',
allTextModels: '全部文本模型', allTextModels: '全部文本模型',
+12 -1
View File
@@ -33,6 +33,8 @@
<!-- 第二十五轮:该模型的参数被上游固定(如 temperature 只能是 1), <!-- 第二十五轮:该模型的参数被上游固定(如 temperature 只能是 1),
挂锁标注 + 悬浮说明,省掉「为什么我传的参数不生效」这类困惑。 --> 挂锁标注 + 悬浮说明,省掉「为什么我传的参数不生效」这类困惑。 -->
<Icon v-if="m.paramNote" name="lock" :size="12" class="plock" :title="m.paramNote" /> <Icon v-if="m.paramNote" name="lock" :size="12" class="plock" :title="m.paramNote" />
<!-- 2026-09-21:免费模型标一颗闪电(与下方表格「能力」列的「免费」同一份数据) -->
<Icon v-if="m.free" name="bolt" :size="12" class="free-ico" :title="t('models.freeHint')" />
<span class="code">{{ m.id }}</span> <span class="code">{{ m.id }}</span>
<!-- 支持的格式不在这里铺标签:这行还要放供应商/延迟/测速按钮,窄卡放不下第三颗 <!-- 支持的格式不在这里铺标签:这行还要放供应商/延迟/测速按钮,窄卡放不下第三颗
(悬停整行可见格式 + 本次测速走的线,见 rowTitle)。权威展示在下方表格的 (悬停整行可见格式 + 本次测速走的线,见 rowTitle)。权威展示在下方表格的
@@ -167,10 +169,14 @@
<span v-if="row.vision" class="pill ok cap"> <span v-if="row.vision" class="pill ok cap">
<Icon name="eye" :size="12" />{{ t('models.visionTag') }} <Icon name="eye" :size="12" />{{ t('models.visionTag') }}
</span> </span>
<!-- 2026-09-21:免费模型(后端 /v1/models 的 free 字段,配置在 models[].free) -->
<span v-if="row.free" class="pill free cap" :title="t('models.freeHint')">
<Icon name="bolt" :size="12" />{{ t('models.freeTag') }}
</span>
<span v-if="paramKeys(row).length" class="pill warn cap" :title="paramNote(row)"> <span v-if="paramKeys(row).length" class="pill warn cap" :title="paramNote(row)">
<Icon name="lock" :size="12" />{{ t('models.paramTag') }} <Icon name="lock" :size="12" />{{ t('models.paramTag') }}
</span> </span>
<span v-if="!row.vision && !paramKeys(row).length" class="muted-2">—</span> <span v-if="!row.vision && !paramKeys(row).length && !row.free" class="muted-2">—</span>
</template> </template>
</el-table-column> </el-table-column>
<el-table-column :label="t('models.keySet')" width="90"> <el-table-column :label="t('models.keySet')" width="90">
@@ -374,6 +380,8 @@ const textModelRows = computed(() =>
id: m.id, id: m.id,
provider: m.provider_name || '—', provider: m.provider_name || '—',
vision: !!m.vision, vision: !!m.vision,
// 免费模型(2026-09-21):与表格「能力」列同一份数据
free: !!m.free,
// 模型级强制参数(第二十五轮):被上游固定住的采样参数,用挂锁标注出来。 // 模型级强制参数(第二十五轮):被上游固定住的采样参数,用挂锁标注出来。
paramNote: paramKeys(m).length ? paramNote(m) : '', paramNote: paramKeys(m).length ? paramNote(m) : '',
// 支持的格式(第二十七轮):悬浮这一行就能看到「能用哪几条线 + 本次测速走的哪条」 // 支持的格式(第二十七轮):悬浮这一行就能看到「能用哪几条线 + 本次测速走的哪条」
@@ -454,6 +462,9 @@ onMounted(load)
.arrow { color: var(--muted-2); } .arrow { color: var(--muted-2); }
.vision { color: var(--primary); } .vision { color: var(--primary); }
.plock { color: var(--warn); } .plock { color: var(--warn); }
/* 免费模型:绿色系,跟「视觉」(主题色) / 「参数固定」(橙) 区分开 */
.free-ico { color: #059669; }
.pill.free { background: rgba(16, 185, 129, 0.14); color: #059669; }
/* 支持的格式:三条线是并列关系(没有谁更优),统一用主题色弱底, /* 支持的格式:三条线是并列关系(没有谁更优),统一用主题色弱底,
不用 ok/warn/err —— 否则「messages」看起来像警告、「responses」像被禁用。 */ 不用 ok/warn/err —— 否则「messages」看起来像警告、「responses」像被禁用。 */
.proto { .proto {
+14
View File
@@ -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] 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(): def test_empty_messages_rejected_and_stream_strict():
"""P2: 空 messages / 拼错的 stream 类型应在入参处被拒(而非打到上游变 502)。""" """P2: 空 messages / 拼错的 stream 类型应在入参处被拒(而非打到上游变 502)。"""
from fastapi.testclient import TestClient from fastapi.testclient import TestClient