v1.74.9-stable - 自動路由器
部署此版本
- Docker
- Pip
docker run litellm
docker run \
-e STORE_MODEL_IN_DB=True \
-p 4000:4000 \
docker.litellm.ai/berriai/litellm:v1.74.9-stable.patch.1
pip install litellm
pip install litellm==1.74.9.post2
主要亮點
- 自動路由器 - 根據請求內容自動將請求路由到特定模型。
- 模型層級防護欄 - 僅在使用特定模型時執行防護欄。
- MCP 標頭傳遞 - 將標頭從用戶端傳遞到後端 MCP。
- 新 LLM 提供者 - 新增 Bedrock inpainting 支援與 Recraft API 圖像生成 / 圖像編輯支援。
自動路由器
此版本導入了依據請求內容自動路由到模型的功能。這表示當 Proxy Admins 選擇啟用自動路由器時,users 可以定義一組關鍵字,讓系統一律路由到特定模型。
這非常適合內部使用情境,因為您不希望 users 去思考要使用哪個模型——例如,使用 Claude 模型進行程式撰寫,而使用 GPT 模型生成廣告文案。
模型層級防護欄
此版本為您的 config.yaml + UI 帶來模型層級防護欄支援。這非常適合當您同時有內部部署與託管模型,且只想執行以防止將 PII 傳送到託管模型的情境。
model_list:
- model_name: claude-sonnet-4
litellm_params:
model: anthropic/claude-sonnet-4-20250514
api_key: os.environ/ANTHROPIC_API_KEY
api_base: https://api.anthropic.com/v1
guardrails: ["azure-text-moderation"] # 👈 KEY CHANGE
guardrails:
- guardrail_name: azure-text-moderation
litellm_params:
guardrail: azure/text_moderations
mode: "post_call"
api_key: os.environ/AZURE_GUARDRAIL_API_KEY
api_base: os.environ/AZURE_GUARDRAIL_API_BASE
MCP 標頭傳遞
v1.74.9-stable 讓您可以透過 LiteLLM 傳遞 MCP 伺服器特定的驗證標頭
- 允許使用者透過標頭指定哪個
header_name要傳遞到哪個mcp_server - 可為同一 MCP 伺服器類型的不同部署新增不同的驗證標頭
新模型 / 更新模型
價格 / Context Window 更新
| 提供者 | 模型 | 上下文視窗 | 輸入($/百萬 tokens) | 輸出($/百萬 tokens) |
|---|---|---|---|---|
| Fireworks AI | fireworks/models/kimi-k2-instruct | 131k | $0.6 | $2.5 |
| OpenRouter | openrouter/qwen/qwen-vl-plus | 8192 | $0.21 | $0.63 |
| OpenRouter | openrouter/qwen/qwen3-coder | 8192 | $1 | $5 |
| OpenRouter | openrouter/bytedance/ui-tars-1.5-7b | 128k | $0.10 | $0.20 |
| Groq | groq/qwen/qwen3-32b | 131k | $0.29 | $0.59 |
| VertexAI | vertex_ai/meta/llama-3.1-8b-instruct-maas | 128k | $0.00 | $0.00 |
| VertexAI | vertex_ai/meta/llama-3.1-405b-instruct-maas | 128k | $5 | $16 |
| VertexAI | vertex_ai/meta/llama-3.2-90b-vision-instruct-maas | 128k | $0.00 | $0.00 |
| Google AI Studio | gemini/gemini-2.0-flash-live-001 | 1,048,576 | $0.35 | $1.5 |
| Google AI Studio | gemini/gemini-2.5-flash-lite | 1,048,576 | $0.1 | $0.4 |
| VertexAI | vertex_ai/gemini-2.0-flash-lite-001 | 1,048,576 | $0.35 | $1.5 |
| OpenAI | gpt-4o-realtime-preview-2025-06-03 | 128k | $5 | $20 |
功能
- Lambda AI
- 新 LLM API 提供者 - PR #12817
- Github Copilot
- 支援動態端點 - PR #12827
- Morph
- 新 LLM API 提供者 - PR #12821
- Groq
- 移除已淘汰的 groq/qwen-qwq-32b - PR #12832
- Recraft
- Azure OpenAI
- 支援 DefaultAzureCredential,無需硬編碼環境變數 - PR #12841
- Hyperbolic
- 新 LLM API 提供者 - PR #12826
- OpenAI
/realtimeAPI - 傳遞 intent 查詢參數 - PR #12838
- Bedrock
- 新增 Amazon Nova Canvas 的 inpainting 支援 - PR #12949 感謝 @SantoshDhaladhuli
錯誤修正
- Gemini (Google AI Studio + VertexAI)
- 修正同步請求時洩漏檔案描述元錯誤 - PR #12824
- IBM Watsonx
- 為 tool choice 使用正確的參數名稱 - PR #9980
- Anthropic
- Openrouter
- 過濾掉非 anthropic 模型的 cache_control 標記(可搭配 claude code 使用)https://github.com/BerriAI/litellm/pull/12850
- Gemini
LLM API 端點
功能
- Passthrough 端點
- 將 key/user/team 成本追蹤改為 OSS - PR #12847
- /v1/models
- 將備援模型作為 API 回應的一部分回傳 - PR #12811 感謝 @murad-khafizov
- /vector_stores
- 將權限管理改為 OSS - PR #12990
錯誤修正
/batches- 在成本追蹤檢查期間略過無效批次(先前會停止所有檢查) - PR #12782
/chat/completions- 修正 .acompletion() 的非同步重試器 - PR #12886
MCP 閘道
功能
- 權限管理
- 將依 key/team 的權限管理改為 OSS - PR #12988
- MCP 別名
- 支援 mcp server 別名(適合在 Cursor 上呼叫很長的 mcp server 名稱)- PR #12994
- 標頭傳遞
- 支援將標頭從用戶端傳遞到後端 MCP(適合將 personal access tokens 傳送到後端 MCP)- PR #13003
管理端點 / UI
功能
- 用量
- 支援依模型群組檢視用量 - PR #12890
- 虛擬金鑰
- 在
/key/generate上新增key_type欄位 - 可指定 key 是否能呼叫 LLM API 與管理路由 - PR #12909
- 在
- 模型
錯誤修正
- SSO
- 防護欄
- 編輯團隊時顯示正確的 guardrails - PR #12823
- 虛擬金鑰
記錄 / 防護欄整合
功能
- Google Cloud Model Armor
- 文件新的防護欄 - PR #12492
- Pillar Security
- 新的 LLM 防護欄 - PR #12791
- CloudZero
- 允許將支出匯出到 cloudzero - PR #12908
- 模型層級防護欄
- 支援模型層級防護欄 - PR #12968
錯誤
- Prometheus
- 修正設定標籤式指標的標籤時的
[tag]=false- PR #12916
- 修正設定標籤式指標的標籤時的
- Guardrails AI
- 使用 ‘validatedOutput’ 以允許使用 “fix” guards - PR #12891 感謝 @DmitriyAlergant
效能 / 負載平衡 / 可靠性改進
功能
錯誤
- forward_clientside_headers
- 從標頭中篩除
content-length(導致後端請求卡住)- PR #12886
- 從標頭中篩除
- 訊息遮罩
- 修正無法 pickle coroutine object 錯誤 - PR #13005
一般 Proxy 改進
功能
- 基準測試
- 更新 litellm proxy 基準測試(p50、p90、p99 額外負擔)- PR #12842
- 請求標頭
- 新增
x-litellm-num-retries請求標頭
- 新增
- Swagger
- 支援自訂 root paths 上的本機 swagger - PR #12911
- 健康狀態
- 追蹤成本 + 為 LiteLLM Proxy 執行的健康檢查新增標籤 - PR #12880
錯誤
- Proxy 啟動
- 修正在啟動時,當 team member budget 為 None 會阻擋啟動的問題 - PR #12843
- Docker
- 分離式健康檢查應用程式
- 透過 supervisord 傳遞 cmd args(讓使用者設定在 docker 中仍可運作)- PR #12871
- Swagger
- 請求標頭
- 將 ‘user_header_name’ 欄位檢查改為不分大小寫(修正 OpenWebUi 的客戶預算強制執行)- PR #12950
- 支出記錄
- 修正 custom_llm_provider 為 None 時寫入 DB 的問題 - PR #13001
新貢獻者
- @magicalne 在 https://github.com/BerriAI/litellm/pull/12804 完成了他們的第一次貢獻
- @pavangudiwada 在 https://github.com/BerriAI/litellm/pull/12798 完成了他們的第一次貢獻
- @mdiloreto 在 https://github.com/BerriAI/litellm/pull/12707 完成了他們的第一次貢獻
- @murad-khafizov 在 https://github.com/BerriAI/litellm/pull/12811 完成了他們的第一次貢獻
- @eagle-p 在 https://github.com/BerriAI/litellm/pull/12791 完成了他們的第一次貢獻
- @apoorv-sharma 在 https://github.com/BerriAI/litellm/pull/12920 完成了他們的第一次貢獻
- @SantoshDhaladhuli 在 https://github.com/BerriAI/litellm/pull/12949 完成了他們的第一次貢獻
- @tonga54 在 https://github.com/BerriAI/litellm/pull/12941 完成了他們的第一次貢獻
- @sings-to-bees-on-wednesdays 在 https://github.com/BerriAI/litellm/pull/12950 完成了他們的第一次貢獻