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:
1 parent
3b83dcfc75
commit
7252d97bb6
8 files changed
+47
-2
No files matched your search
@@ -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`
|
||||||
|
|||||||
@@ -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(
|
||||||
|
|||||||
@@ -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})
|
||||||
|
|||||||
@@ -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 → 标两条线。
|
||||||
|
|||||||
@@ -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',
|
||||||
|
|||||||
@@ -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: '全部文本模型',
|
||||||
|
|||||||
@@ -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 {
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
Reference in new issue
Block a user