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