让状态页成为口碑的一部分
技术社区里流传最广的往往不是最好的服务,而是那些「出事了会说清楚」的服务。一个诚实的状态页,回报率远高于它的开发成本。
公开透明比藏着掖着更能建立信任
把降级、未知、部分不可用都如实展示出来,用户反而更宽容——因为他们知道系统是清醒的。
第二,unknown 必须诚实地展示出来。整体状态在存在未知或不支持的目标时,不应该宣称「全部正常」。
成功率、时间窗口、历史保留时长——这些数字如果口径不透明,看板就失去了参考价值。
让用户能自己判断要不要重试
页面上的状态和延迟趋势,足够用户自己决定「现在调还是等十分钟」。这减少了无谓的重复请求。
宁可让用户看到「部分未知」,也不要给一个虚假的绿色。
否则用户会来问「我什么都没干,为什么额度少了」。
把故障和用量关联起来
故障期间用户往往会加重试,账单会异常。如果状态页能解释这一点,能减少很多误解。
用量统计的时间口径必须写清楚,是 UTC 还是某个业务时区,一周从哪天开始。
一旦这里含糊,用户看到的「今日用量」就会和他自己的记录对不上。
文档里放状态页链接
让排查的第一步是「看一眼状态」,而不是「提工单」。这是最有效的降压手段。
模型 ID 不要从文档里抄,要用你的 Key 实际查一次 /v1/models 拿到真实可用的那个。
因为网关支持模型映射别名,文档里的名字和你实际能调的名字可能不是同一个。
实操:把健康看板的数据接进你自己的监控。
这个页面不需要登录,任何人打开就能看——这本身就是一种信任表达。
curl -s "https://aiminis.info/api/v1/model-health" | python3 -c "
import json, sys
d = json.load(sys.stdin)['data']
print('探测间隔:', d['interval_seconds'], '秒')
for it in d['items']:
rate = it.get('success_rate')
rate = 'n/a' if rate is None else f'{rate:.1f}%'
print(f\"{it['model']:<24} {it['status']:<12} {it['latency_ms']:>6}ms 成功率 {rate}\")
"
# 关键点:这个接口是公开只读的,不需要 Key,
# 但探测消耗的是上游额度,不会扣到任何用户头上。
几个容易踩的坑
- 把「未知」显示成「正常」,用户信了然后发现调不通。
- 健康探测的请求被记在某个用户 Key 名下,账单凭空多出一截。
- 拿 HEAD 探测的网络往返当成模型响应延迟来判断性能。
- 把上游故障率和本站请求失败率混为一谈,误判故障范围。
小结
先跑通最小请求,再逐项加功能——这是接入任何网关都适用的节奏。
上面提到的能力基本都来自 https://aiminis.info/ 这个自建的 API 网关,支持 OpenAI 与 Anthropic 双协议接入,还有公开的模型健康看板 https://aiminis.info/model-health 可以先看看状态。
- 点赞
- 收藏
- 关注作者
评论(0)