ghcr.io/berriai/litellm:v1.87.0-dev.1

🚅 LiteLLM

LiteLLM AI 网关

支持 100+ 大语言模型（LLM）的开源 AI 网关。可自托管，企业级就绪。以 OpenAI 格式调用任何 LLM。

LiteLLM 代理服务器（AI 网关） | 托管代理 | 企业版 | 网站

---

什么是 LiteLLM

LiteLLM 是一个开源 AI 网关，为您提供单一、统一的接口，可使用 OpenAI 格式调用 100+ LLM 提供商——包括 OpenAI、Anthropic、Gemini、Bedrock、Azure 等。

您可以将其用作 Python SDK 进行直接库集成，或将 AI 网关（代理服务器） 部署为团队或组织的集中式服务。

跳转到 LiteLLM 代理（LLM 网关）文档 跳转到支持的 LLM 提供商

---

为什么选择 LiteLLM

跨提供商管理 LLM 调用很快会变得复杂——每个模型都有不同的 SDK、身份验证模式、请求格式和错误类型。LiteLLM 消除了这种摩擦：

• 统一 API ——一个接口支持 100+ LLM，无需处理特定于提供商的 SDK
• 即插即用的 OpenAI 兼容性 ——无需重写代码即可切换提供商
• 生产就绪的网关 ——开箱即用地提供虚拟密钥、支出跟踪、安全护栏、负载均衡和管理仪表板
• 8ms P95 延迟（在 1k RPS 下）(基准测试)

开源采用者

Netflix

---

功能

LLM - 调用 100+ LLM（Python SDK + AI 网关）

所有支持的端点 - /chat/completions、/responses、/embeddings、/images、/audio、/batches、/rerank、/a2a、/messages 等。

Python SDK

uv add litellm

from litellm import completion
import os

os.environ["OPENAI_API_KEY"] = "your-openai-key"
os.environ["ANTHROPIC_API_KEY"] = "your-anthropic-key"

# OpenAI
response = completion(model="openai/gpt - 4o", messages=[{"role": "user", "content": "Hello!"}])

# Anthropic
response = completion(model="anthropic/claude - sonnet - 4 - 20250514", messages=[{"role": "user", "content": "Hello!"}])

AI 网关（代理服务器）

快速开始 - 端到端教程 - 设置虚拟密钥，发出第一个请求

uv tool install 'litellm[proxy]'
litellm --model gpt - 4o

import openai

client = openai.OpenAI(api_key="anything", base_url="http://0.0.0.0:4000")
response = client.chat.completions.create(
model="gpt - 4o",
messages=[{"role": "user", "content": "Hello!"}]
)

文档：LLM 提供商

代理 - 调用 A2A 代理（Python SDK + AI 网关）

支持的提供商 - LangGraph、Vertex AI Agent Engine、Azure AI Foundry、Bedrock AgentCore、Pydantic AI

Python SDK - A2A 协议

from litellm.a2a_protocol import A2AClient
from a2a.types import SendMessageRequest, MessageSendParams
from uuid import uuid4

client = A2AClient(base_url="http://localhost:10001")

request = SendMessageRequest(
id=str(uuid4()),
params=MessageSendParams(
message={
"role": "user",
"parts": [{"kind": "text", "text": "Hello!"}],
"messageId": uuid4().hex,
}
)
)
response = await client.send_message(request)

AI 网关（代理服务器）

步骤 1. 将您的代理添加到 AI 网关

步骤 2. 通过 A2A SDK 调用代理

from a2a.client import A2ACardResolver, A2AClient
from a2a.types import MessageSendParams, SendMessageRequest
from uuid import uuid4
import httpx

base_url = "http://localhost:4000/a2a/my - agent" # LiteLLM proxy + agent name
headers = {"Authorization": "Bearer sk - 1234"} # LiteLLM Virtual Key

async with httpx.AsyncClient(headers=headers) as httpx_client:
resolver = A2ACardResolver(httpx_client=httpx_client, base_url=base_url)
agent_card = await resolver.get_agent_card()
client = A2AClient(httpx_client=httpx_client, agent_card=agent_card)

request = SendMessageRequest(
id=str(uuid4()),
params=MessageSendParams(
message={
"role": "user",
"parts": [{"kind": "text", "text": "Hello!"}],
"messageId": uuid4().hex,
}
)
)
response = await client.send_message(request)

文档：A2A 代理网关

MCP 工具 - 将 MCP 服务器连接到任何 LLM（Python SDK + AI 网关）

Python SDK - MCP 桥接

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
from litellm import experimental_mcp_client
import litellm

server_params = StdioServerParameters(command="python", args=["mcp_server.py"])

async with stdio_client(server_params) as (read, write):
async with ClientSession(read, write) as session:
await session.initialize()

# Load MCP tools in OpenAI format
tools = await experimental_mcp_client.load_mcp_tools(session=session, format="openai")

# Use with any LiteLLM model
response = await litellm.acompletion(
model="gpt - 4o",
messages=[{"role": "user", "content": "What's 3 + 5?"}],
tools=tools
)

AI 网关 - MCP 网关

步骤 1. 将您的 MCP 服务器添加到 AI 网关

步骤 2. 通过 /chat/completions 调用 MCP 工具

curl - X POST 'http://0.0.0.0:4000/v1/chat/completions' \
-H 'Authorization: Bearer sk - 1234' \
-H 'Content-Type: application/json' \
-d '{
"model": "gpt - 4o",
"messages": [{"role": "user", "content": "Summarize the latest open PR"}],
"tools": [{
"type": "mcp",
"server_url": "litellm_proxy/mcp/github",
"server_label": "github_mcp",
"require_approval": "never"
}]
}'

与 Cursor IDE 配合使用

{
"mcpServers": {
"LiteLLM": {
"url": "http://localhost:4000/mcp/",
"headers": {
"x - litellm - api - key": "Bearer sk - 1234"
}
}
}
}

文档：MCP 网关

支持的提供商 (网站支持的模型 | 文档)

贡献指南

我们欢迎对 LiteLLM 的贡献！无论您是修复错误、添加功能还是改进文档，我们都感谢您的帮助。

贡献者快速入门

这需要安装 uv。

git clone https://github.com/BerriAI/litellm.git
cd litellm
make install-dev # 安装开发依赖
make format # 格式化代码
make lint # 运行所有 lint 检查
make test-unit # 运行单元测试
make format-check # 仅检查格式

有关详细的贡献指南，请参阅 CONTRIBUTING.md。

[!NOTE] 参与文档贡献？ LiteLLM 文档已迁移到单独的仓库：https://github.com/BerriAI/litellm-docs%E3%80%82%E8%AF%B7%E5%9C%A8%E8%AF%A5%E4%BB%93%E5%BA%93%E6%8F%90%E4%BA%A4%E6%96%87%E6%A1%A3 PR。文档托管于 docs.litellm.ai。

代码质量 / Linting

LiteLLM 遵循 https://google.github.io/styleguide/pyguide.html%E3%80%82

我们的自动化检查包括：

• Black 用于代码格式化
• Ruff 用于 linting 和代码质量检查
• MyPy 用于类型检查
• 循环导入检测
• 导入安全检查

您的 PR 必须通过所有这些检查才能合并。

支持 / 与创始人交流

• 预约演示 👋
• 社区 *** 💭
• 社区 Slack 💭
• 我们的*** ✉️ 是 *** / ***

贡献者