第二十七轮: 三线直传(/v1/messages,/v1/responses)+删除路由别名;第二十八轮: element-plus 按需引入+死代码清理+前端支持格式列/API Key 文档

This commit is contained in:
api-gateway committed 2026-09-18 16:33:33 +08:00
1 parent 1e1130a8ad
commit 327721b8ef
28 files changed
+3016 -1263

No files matched your search

+39 -48
View File
@@ -19,10 +19,10 @@ export default {
control: '控制台',
more: '更多',
subdashboard: '网关运行概况 · 数据每 8 秒刷新',
subchat: '支持附图视觉 · 路由 wjd 自动选路',
subchat: '支持附图视觉 · 多供应商直连',
subimages: '参数在左 · 历史在右 · 下载走网关代拉',
subvideos: '720P · 时长 4–12 秒 · 异步轮询',
submodels: '供应商 / 模型 / 路由链',
submodels: '供应商 / 模型 / 协议线',
submetrics: '用量与成本 · 按账号隔离',
subkeys: '每个账号最多 3 把 · 明文保存,可反复复制',
subusers: '账号与权限 · 管理员可查他人日志与资产',
@@ -86,8 +86,6 @@ export default {
dashboard: {
modelCount: '模型数',
providers: '供应商',
routes: '路由别名',
fallback: '成功降级',
inflight: '当前并发',
callsMix: '调用 ok/fail',
provShare: '供应商成功调用份额',
@@ -97,7 +95,6 @@ export default {
circuit: '熔断',
modelCountShort: '模型数',
keySet: '已配 Key',
routeAlias: '路由别名',
name: '名称',
modelChain: '模型链',
gatewayInfo: '网关信息',
@@ -114,7 +111,6 @@ export default {
requests: '请求总数',
successRate: '成功率',
avgLatency: '平均延迟',
fallbackShort: '成功降级',
noteOkFail: 'ok {ok} · fail {fail}',
noteFail: '失败 {n} 次',
noteP95: 'P95 最高 {v}s',
@@ -127,22 +123,21 @@ export default {
noModels: '暂无调用记录',
share: '份额',
live: '实时',
routeChain: '可用性 + 速度优先链',
byProtocol: '协议线覆盖',
byProtocolSub: '每条线有多少模型',
modelCountN: '{n} 个模型',
},
metrics: {
uptime: '已运行',
inflight: '在途/峰值',
fallback: '成功降级',
promptTokens: 'Prompt tokens',
completionTokens: 'Completion tokens',
callsTotal: '总调用(ok/fail)',
modelCalls: '各模型调用(成功 / 失败)',
provShare: '供应商成功调用份额',
routeVsProvider: '路由 vs 供应商调用(成功 / 失败 / 降级)',
latency: '模型延迟 P50 / P95(秒)',
success: '成功',
fail: '失败',
fallback2: '降级',
ok: 'ok',
none: '暂无',
circuitStatus: '熔断器状态',
@@ -165,6 +160,7 @@ export default {
failRateNote: '失败率 {v}%',
snapshot: '实时快照',
circuitCard: '熔断器',
byProvider: '按供应商调用(成功 / 失败)',
},
logs: {
all: '全部',
@@ -226,20 +222,17 @@ export default {
systemShort: '系统提示',
visionReady: '视觉能力已就绪 · 可附图',
visionOff: '当前模型不支持图像输入',
chainLabel: '{id}({chain})',
emptyChain: '空',
phDefault: '默认',
phOptional: '可选',
totalTokens: '共 {n}',
uploadedImage: '已上传图片',
reasoningTag: '推理',
routeGroup: '路由(自动降级)',
textModels: '文本模型',
params: '参数',
clear: '清空',
generating: '正在生成…',
empty: '开始与网关对话(可选任意文本模型或路由 wjd)',
fallback: '降级 · 由 {provider} 响应',
empty: '开始与网关对话(在下方选一个模型)',
servedBy: '由 {provider} 响应',
requestedTo: '请求 {req} → 实际 {served}',
reasoning: '推理过程(reasoning)',
@@ -266,6 +259,7 @@ export default {
streaming: '流式输出',
system: '系统提示词(每条会话开头注入)',
loadModelsErr: '加载模型列表失败:{msg}',
pickModel: '选择模型',
},
images: {
historyTitle: '生成历史',
@@ -363,10 +357,8 @@ export default {
loadErr: '加载视频失败',
},
models: {
routeAliasTitle: '路由别名(自动降级链)',
modelListTitle: '模型清单',
name: '名称',
chainLabel: '模型链(依次尝试,失败自动降级)',
providerCount: '供应商数',
id: '模型 ID',
type: '类型',
@@ -375,12 +367,10 @@ export default {
text: '文本',
image: '图像',
video: '视频',
route: '路由',
model: '模型',
textModels: '文本模型',
imageModels: '图像模型',
videoModels: '视频模型',
routes: '路由别名',
providers: '供应商',
loadErr: '加载模型失败',
capability: '能力',
@@ -391,10 +381,8 @@ export default {
providerCard: '供应商',
keyOk: 'Key 已配置',
keyMissing: 'Key 未配置',
routeCount: '{n} 条路由',
chainCount: '{n} 个模型',
providerCount2: '{n} 家供应商',
noRoute: '没有配置路由别名',
speedtest: '一键测速',
testing: '正在测试全部文本模型延迟…',
testingShort: '测速中…',
@@ -403,6 +391,15 @@ export default {
failed: '失败',
speedtestDone: '测速完成,共 {n} 个模型',
speedtestFail: '测速失败',
speedtestHint: '按模型自己的协议线探测延迟',
textModelCount: '{n} 个文本模型',
// 第二十七轮:支持的格式列(三条协议线)。格式名直接用各家标准端点名,不译。
protocols: '支持的格式',
protocolHint: '该模型可以走哪几条线:chat/completions(OpenAI 兼容)、messages(Anthropic)、responses(OpenAI Responses)。不在列表里的格式会在网关入口直接 400 —— 网关不做跨格式转换,也绝不偷偷换个模型顶上',
protocolNa: '不适用',
protocolNaHint: '图像 / 视频模型走 /v1/images/generations、/v1/videos 专用端点,不涉及这三条协议线',
protocolHintRow: '支持的格式:{lines} ',
probedLine: '本次测速走 {p}',
},
history: {
saveFail: '历史未能保存到服务端(刷新后可能丢失),请检查登录状态或网络',
@@ -435,7 +432,7 @@ export default {
logoutBtn: '退出登录',
chatDefaults: '对话默认参数',
defsTip: '作为对话页初始值(本会话已改动的参数不受影响)。',
defaultModel: '默认模型 / 路由',
defaultModel: '默认模型',
temperature: '温度 temperature',
topP: 'top_p',
maxTokens: 'max_tokens(留空用网关默认)',
@@ -448,7 +445,7 @@ export default {
modelsCount: '模型数',
userManagement: '账号管理(管理员)',
gwConfigBtn: '去配置',
gwConfigSub: '改网关参数 / 供应商 / 路由 / 定价 —— 保存即生效',
gwConfigSub: '改网关参数 / 供应商 / 定价 —— 保存即生效',
gwConfig: '网关配置(管理员)',
userCol: '账号',
roleCol: '角色',
@@ -504,38 +501,50 @@ export default {
auth: '鉴权',
authVal: '请求头 Authorization: Bearer <你的 API Key>',
modelPick: '模型选择',
modelPickVal: 'model 填 wjd = 路由别名(按「可用 + 速度」自动降级,推荐);也可填具体模型 id 直连,不被降级影响',
modelPickVal: 'model 填真实模型 id(如 agnes-3.0-flash);三条线各按自家协议直传,网关不做跨格式转换 —— 选错线会 400(响应里会列出该模型支持哪些线)',
formats: '支持的格式',
formatsVal: '每个模型能用哪几条线,见「供应商与模型」页的「支持的格式」列:chat/completions、messages、responses。三条线各自原样转发(不改字段、不做跨格式翻译),因此接口地址与请求体按各家官方 SDK 写就行',
ctype: '请求格式',
ctypeVal: 'application/json;对话支持 SSE 流式(stream: true)',
endpoints: '常用端点',
colMethod: '方法',
colPath: '路径',
colDesc: '说明',
epModels: '模型与路由列表(含视觉能力标记)',
epModels: '模型列表(含视觉能力标记与支持的协议线)',
epChat: '对话补全(OpenAI 兼容,支持流式与图片输入)',
epMessages: '对话补全(Anthropic Messages 格式,原样直传)',
epResponses: '对话补全(OpenAI Responses 格式,原样直传)',
epImages: '图像生成 / 图生图(n 必须为 1,多张请多次调用)',
epVideoCreate: '视频生成(异步,立即返回 video_id)',
epVideoPoll: '查询视频任务(建议每 5s 一次;被上游限流时返回 throttled)',
epDownload: '代下载生成出来的图片 / 视频(绕过上游地址的防盗链与过期,白名单域名)',
epHistory: '读取本人历史(图像 / 视频 / 对话)',
epLogs: '本人调用日志',
epMetrics: '指标快照(含熔断器状态)',
epHealth: '健康检查(版本 / 供应商状态)',
exChat: '示例 · 对话',
exMessages: '示例 · 对话(Anthropic Messages 格式)',
exResponses: '示例 · 对话(OpenAI Responses 格式)',
exImg: '示例 · 图像生成',
exVideo: '示例 · 视频生成 + 轮询',
exPy: '示例 · Python(OpenAI SDK 兼容)',
// 示例代码里的注释与示例文案(整段照抄时也该是当前语言)
sampleChat: '你好,介绍一下你自己',
sampleModelMessages: 'minimax-m2.7',
sampleModelResponses: 'grok-4.6',
sampleImg: '霓虹夜景的城市街道',
sampleVideo: '镜头缓慢推进',
sampleStep1: '提交任务(异步,立即返回 video_id)',
sampleStep2: '每 5s 轮询一次(被限流会回 throttled,等一下再问)',
notes: '注意事项',
noteVision: '带图对话请用支持视觉的模型(agnes-3.0-flash,列表里标「视觉」);填路由别名 wjd 时网关会自动把视觉模型排到链首。',
noteVision: '带图对话请用支持视觉的模型(agnes-3.0-flash,列表里标「视觉」);网关不再自动换模型 —— 选了不支持视觉的模型就照原样发上去,由上游决定怎么处理',
noteCross: '跨格式不转换:某个模型支持哪几条线,由「供应商与模型」页的「支持的格式」列决定(例:minimax-m2.7 只认 messages,grok-4.6 只认 responses)。用错格式网关会在入口直接 400 并列出它支持的线,不会偷偷翻译你的请求、也不会换个模型顶上',
noteConvId: '可选字段 conversation_id(对话类请求):同一段对话复用同一个串,上游的提示词缓存更容易命中(省钱省时)。它是网关内部字段,不会原样发给上游 —— 网关按账号派生真实会话 id,账号之间互不串缓存;不传则每次随机',
noteN1: '图像 n 只能为 1(上游限制),要几张就调几次;n≠1 会被网关直接 400 拦下。',
noteVideo: '视频 seconds 只支持 4–12,size 固定 720P,比例 6 种(21:9/16:9/4:3/1:1/3:4/9:16);mode=text 文生视频 / keyframe 首尾帧 / reference 参考图·音频。',
notePoll: '轮询别快于 5s(上游会回 429「查询过于频繁」,网关会以 throttled 提示退避)。',
noteMedia: '素材(参考图 / 首尾帧 / 参考音频 / 对话附图)可直接传 data:image/...;base64,... 或公网 URL;data URI 不必暴露素材,但单次请求体需 < 2MB。',
noteDownload: '上游返回的图片 / 视频地址可能有时效或防盗链。要落盘请走 /v1/media/download?url=...(需带上你的 Key),它由网关代为取回;地址不在白名单内会被 400 拒绝。',
noteKey: 'Key 泄漏时到本页删除(立即 401),或用「用户管理」页一键吊销该账号全部 Key。',
noteAudit: '所有调用按账号记入「日志」页(仅本人可见;admin 可在用户管理页看各账号)。',
copyBase: '复制地址',
@@ -656,17 +665,13 @@ export default {
addItem: '添加',
addModel: '添加模型',
addProvider: '添加供应商',
addRoute: '添加路由别名',
addPrice: '添加定价',
delete: '删除',
delProvider: '删除供应商',
delRoute: '删除路由',
delConfirm: '删除「{name}」?保存后才真正写盘生效。',
needKey: '供应商的 key 不能为空',
needRoute: '路由别名的名字不能为空',
dupKey: '「{name}」重复了,请改一个名字',
newProvider: '(新供应商)',
newRoute: '(新路由别名)',
unlimited: '留空 = 不限',
useServerTimeout: '留空 = 用 server.timeout',
mediaEmpty: '留空 = 不支持',
@@ -683,19 +688,17 @@ export default {
tabServerSub: '监听、超时/重试、限流、CORS、会话时长等运行开关',
tabProviders: '供应商与模型',
tabProvidersSub: '供应商密钥来源、接口地址、图像/视频端点、模型清单',
tabRoutes: '路由与熔断',
tabRoutesSub: '路由别名与 fallback 模型链(顺序 = 优先级)+ 供应商熔断',
tabLog: '日志与定价',
tabLogSub: '日志级别/格式/容量 + 模型定价(人民币 / 百万 token)',
tabDownload: '下载代理',
tabDownloadSub: '允许网关代下载的 CDN 域名与单文件上限',
circuit: '供应商熔断',
h_circuit: '某供应商窗口内失败到阈值就熔断冷却,期间跳过它让 fallback 顶上',
h_circuit: '某供应商窗口内失败到阈值就熔断冷却,期间它的请求直接 503',
f_c_enabled: '启用熔断',
f_c_failure_threshold: '触发阈值(次)',
f_c_cooldown: '熔断冷却(秒)',
f_c_window: '统计窗口(秒)',
h_c_enabled: '关掉 = 失败也不跳过(fallback 照常工作)',
h_c_enabled: '关掉 = 失败也不跳过',
h_c_failure_threshold: '窗口内失败到该次数就熔断',
h_c_cooldown: '熔断期间直接跳过该供应商,冷却结束后自动半开试探',
h_c_window: '按"窗口内失败次数"计数(不是连续失败)',
@@ -705,9 +708,9 @@ export default {
f_port: '监听端口',
h_port: '生产用 8808,且 Nginx 反代指向它 —— 改了要同步改反代',
f_timeout: '上游超时(秒)',
h_timeout: '单次上游请求超时;路由自身写了 timeout 的以路由为准',
h_timeout: '单次上游请求超时',
f_retry: '直连模型重试次数',
h_retry: '直接用模型 id(不走路由别名)时的重试次数,含首次',
h_retry: '同一模型的重试次数(含首次)',
f_health_auth: '/health 需要鉴权',
// 注意:vue-i18n 把 {...} 当占位符,花括号要么写成 {'{'} / {'}'},要么整条编译不过 ——
// 编译不过的表现是"用到这条文案的整块界面不渲染",不报在文案上(踩过一次,见 check:i18n)。
@@ -720,7 +723,7 @@ export default {
f_metrics_enabled: '记录调用指标',
h_metrics_enabled: '关掉后 /metrics 与看板计数停更(不影响调用)',
f_rate_limit_rps: '全局单账号 QPS 上限',
h_rate_limit_rps: '留空 = 不限(供应商级、路由级限流见各自配置)',
h_rate_limit_rps: '留空 = 不限(供应商级限流见供应商配置)',
f_max_body_size: '请求体上限(字节)',
h_max_body_size: '约 2MB = 2000000;带图对话别调太小',
f_cors_origins: 'CORS 允许来源',
@@ -757,18 +760,6 @@ export default {
pModels: '模型清单',
h_pModels: '模型 id 必须与上游一致;vision = 支持图像输入(带图对话会优先选它)',
mVision: '视觉',
// ── 路由 ──
routeHint: '路由别名是给调用方用的"虚拟模型名"(如 wjd):按下面顺序逐个尝试,全失败才 502。数组顺序 = 优先级。',
rName: '别名',
h_rName: '调用时 model 填这个名字',
rTimeout: '单模型超时(秒)',
h_rTimeout: '某个模型多久没出结果就切下一个,避免整链挂死',
rRetry: '单模型重试次数',
h_rRetry: '切下一个之前的重试次数(含首次);想让链路快速切换就填 1',
rRate: '本路由 QPS 上限',
h_rRate: '留空 = 不限',
rModels: 'fallback 模型链',
h_rModels: '从上到下依次尝试;可用模型来自上面的供应商清单',
// ── 可观测性 ──
f_o_log_level: '日志级别',
h_o_log_level: 'DEBUG 最啰嗦,生产 INFO 够用',