2.1 KiB
模型命名空间
2026-10-27 起新增客户端命名空间，保留旧名兼容。实际型号、协议、凭据、个人热词和 SMART 均不改变；latest 不代表自动跟踪发布。
| 前缀 | 含义 |
|---|---|
| zenmux/ | ZenMux 订阅直连，不跨 provider 回退 |
| zenmux-payg/ | ZenMux PAYG，仅显式请求 |
| openrouter/ | OpenRouter 直连 |
| auto/ | 开源模型 ZenMux 订阅优先，故障回退 OpenRouter |
| aistudio/ | Google AI Studio |
| vertex/ | Google Vertex |
| codex/ | Codex OAuth 订阅 |
| xai/ | xAI OAuth 订阅 |
常规旧别名加对应前缀。特殊转换：gemini-flash-zenmux → zenmux/gemini-flash-latest；gemini-*-vertex → vertex/gemini-*-latest；gemini-embedding-2-studio → aistudio/gemini-embedding-2；google-rerank-default/fast → vertex/rerank-default/fast-latest；gpt-work-sol → codex/gpt-6-sol；gpt-review-5.5 → codex/gpt-5.5。PAYG 去掉旧 -payg 后缀，改加 zenmux-payg/ 前缀。
六组开源模型 deepseek-flash-latest、deepseek-pro-latest、glm-latest、glm-flash-latest、kimi-latest、mimo-flash-latest 各提供 auto/、zenmux/、openrouter/ 三种选择。旧自动回退名和旧 -openrouter 名保留。
tools-pve 的个人语音名为 aistudio/gemini-transcribe-personal；HK 使用 vertex/gemini-transcribe-personal，不能互换两端 provider。HK 四款 ZenMux ASR 别名为 zenmux/gpt-transcribe、zenmux/qwen-audio-3.1-asr-flash、zenmux/doubao-seed-asr-2.0、zenmux/mimo-v2.5-asr。HK 的四个历史 Google 兼容名保留。
只有凭据已就绪的路线才生成。新旧别名的 litellm_params 必须完全相同，不能把客户端前缀当作上游 provider 参数。受模型白名单限制的 virtual key 需要另行授权新名；不扩大既有 key 权限。旧名暂不删除，待所有客户端完成迁移后单独处理。
修改 renderer 后，通过 Arcane Git Sync 同步，并重启对应 LiteLLM 进程使 /tmp/litellm.yaml 重建；仅同步代码不代表进程已加载。逐节点确认 /v1/models、新旧路由参数等价、fallback 配置及实际请求。