项目文件夹

文件
wehub-resource-sync 9a6da7d40d
Publish Docker image / Build and publish (push) Failing after 0s
CI / Python tests (push) Failing after 4s
chore: import upstream snapshot with attribution
2026-07-13 12:03:55 +08:00

271 行
8.8 KiB
Python

from dataclasses import dataclass
DEFAULT_LLM_PROVIDER_ID = "moonshot"
@dataclass(frozen=True, slots=True)
class LLMProviderField:
"""描述 Provider 除 API Key、Base URL、模型名之外的额外配置字段。"""
config_suffix: str
label_key: str
required: bool = False
secret: bool = False
default_value: str = ""
@dataclass(frozen=True, slots=True)
class LLMProviderSpec:
"""
LLM Provider 的集中声明。
这里集中保存跨 WebUI、配置加载和服务调用都会使用的稳定元数据,包括默认
展示名称和 locale key,但不保存具体翻译文案,也不实现 API 请求。这样
Provider 的“是什么”由 Registry 维护,“怎么调用”仍由服务层适配器负责。
"""
provider_id: str
default_label: str
adapter: str = "openai_compatible"
api_key_url: str = ""
default_model: str = ""
default_base_url: str = ""
requires_api_key: bool = True
requires_model_name: bool = True
requires_base_url: bool = True
show_api_key: bool = True
show_base_url: bool = True
deprecated_models: tuple[str, ...] = ()
deprecated_base_urls: tuple[str, ...] = ()
extra_fields: tuple[LLMProviderField, ...] = ()
@property
def label_key(self) -> str:
return f"llm_provider_label.{self.provider_id}"
@property
def tips_key(self) -> str:
return f"llm_provider_tips.{self.provider_id}"
def config_key(self, suffix: str) -> str:
return f"{self.provider_id}_{suffix}"
def resolve_model_name(self, configured_model: str | None) -> str:
"""将空值或已废弃的历史默认值统一解析为当前默认模型。"""
model_name = (configured_model or "").strip()
if not model_name or model_name in self.deprecated_models:
return self.default_model
return model_name
def resolve_base_url(self, configured_base_url: str | None) -> str:
"""解析 Base URL,并将已经停用的历史地址迁移到当前默认值。"""
base_url = (configured_base_url or "").strip()
deprecated_urls = {url.rstrip("/") for url in self.deprecated_base_urls}
if not base_url or base_url.rstrip("/") in deprecated_urls:
return self.default_base_url
return base_url
# 元组顺序就是 WebUI 下拉框顺序。新增普通 OpenAI-compatible Provider 时,
# 通常只需要在这里增加一项并补充 locale;只有协议不同的 Provider 才需要在
# app/services/llm.py 中增加对应 adapter 实现。
LLM_PROVIDER_REGISTRY = (
# 推荐 Provider
LLMProviderSpec(
"moonshot",
"Kimi / Moonshot AI",
api_key_url="https://platform.kimi.com/console/api-keys?aff=MoneyPrinterTurbo",
default_model="kimi-k2.7-code",
default_base_url="https://api.moonshot.cn/v1",
),
# 主流模型原厂与云厂商
LLMProviderSpec(
"openai",
"OpenAI",
api_key_url="https://platform.openai.com/api-keys",
default_model="gpt-5.5",
default_base_url="https://api.openai.com/v1",
),
LLMProviderSpec(
"gemini",
"Google Gemini",
adapter="gemini",
api_key_url="https://aistudio.google.com/app/apikey",
default_model="gemini-3.1-pro-preview",
requires_base_url=False,
show_base_url=False,
deprecated_models=("gemini-pro", "gemini-1.0-pro"),
),
LLMProviderSpec(
"deepseek",
"DeepSeek",
api_key_url="https://platform.deepseek.com/api_keys",
default_model="deepseek-v4-pro",
default_base_url="https://api.deepseek.com",
),
LLMProviderSpec(
"qwen",
"Alibaba Cloud Qwen",
adapter="qwen",
api_key_url="https://dashscope.console.aliyun.com/apiKey",
default_model="qwen-max",
requires_base_url=False,
show_base_url=False,
),
LLMProviderSpec(
"azure",
"Microsoft Azure OpenAI",
adapter="azure",
api_key_url=(
"https://portal.azure.com/#view/"
"Microsoft_Azure_ProjectOxford/CognitiveServicesHub/~/OpenAI"
),
default_model="gpt-35-turbo",
),
LLMProviderSpec(
"volcengine",
"ByteDance VolcEngine Ark",
api_key_url=(
"https://www.volcengine.com/activity/ai618?utm_campaign=hw&"
"utm_content=hw&utm_medium=devrel_tool_web&utm_source=OWO&"
"utm_term=MoneyPrinterTurbo"
),
default_model="doubao-seed-2-1-turbo-260628",
default_base_url="https://ark.cn-beijing.volces.com/api/v3",
),
LLMProviderSpec(
"grok",
"xAI Grok",
api_key_url="https://console.x.ai/",
default_model="grok-4.3",
default_base_url="https://api.x.ai/v1",
),
LLMProviderSpec(
"minimax",
"MiniMax",
api_key_url="https://platform.minimax.io/",
default_model="MiniMax-M3",
default_base_url="https://api.minimax.io/v1",
),
LLMProviderSpec(
"mimo",
"Xiaomi MiMo",
api_key_url=(
"https://platform.xiaomimimo.com/docs/zh-CN/quick-start/first-api-call"
),
default_model="mimo-v2.5-pro",
default_base_url="https://api.xiaomimimo.com/v1",
),
# 聚合与统一接入平台
LLMProviderSpec(
"cloudflare",
"Cloudflare AI Gateway",
adapter="cloudflare_ai_gateway",
api_key_url="https://dash.cloudflare.com/",
default_model="openai/gpt-4.1-mini",
requires_base_url=False,
show_base_url=False,
deprecated_models=("@cf/meta/llama-3.1-8b-instruct",),
extra_fields=(
LLMProviderField("account_id", "Account ID", required=True),
LLMProviderField(
"gateway_id",
"Gateway ID",
default_value="default",
),
),
),
LLMProviderSpec(
"modelscope",
"Alibaba ModelScope",
adapter="modelscope",
api_key_url=("https://modelscope.cn/docs/model-service/API-Inference/intro"),
default_model="ZhipuAI/GLM-5.2",
default_base_url="https://api-inference.modelscope.cn/v1/",
),
LLMProviderSpec(
"aihubmix",
"AIHubMix",
api_key_url="https://aihubmix.com/",
default_model="gpt-5.4-mini",
default_base_url="https://aihubmix.com/v1",
),
LLMProviderSpec(
"aimlapi",
"AIML API",
api_key_url="https://aimlapi.com/app/keys",
default_model="openai/gpt-5-5",
default_base_url="https://api.aimlapi.com/v1",
),
LLMProviderSpec(
"evolink",
"EvoLink",
api_key_url="https://evolink.ai/dashboard/keys",
default_model="gpt-5.5",
default_base_url="https://direct.evolink.ai/v1",
),
# 本地部署与通用网关
LLMProviderSpec(
"ollama",
"Ollama",
requires_api_key=False,
show_api_key=False,
),
LLMProviderSpec(
"oneapi",
"OneAPI",
api_key_url="https://github.com/songquanpeng/one-api",
),
LLMProviderSpec(
"litellm",
"LiteLLM",
adapter="litellm",
default_model="openai/gpt-4o-mini",
requires_api_key=False,
requires_base_url=False,
show_api_key=False,
show_base_url=False,
),
# 其它推理与公共服务
LLMProviderSpec(
"groq",
"Groq",
api_key_url="https://console.groq.com/keys",
default_model="llama-3.3-70b-versatile",
default_base_url="https://api.groq.com/openai/v1",
),
LLMProviderSpec(
"pollinations",
"Pollinations AI",
api_key_url="https://enter.pollinations.ai/",
default_model="openai-fast",
default_base_url="https://gen.pollinations.ai/v1",
deprecated_models=("default",),
deprecated_base_urls=("https://text.pollinations.ai/openai",),
),
)
LLM_PROVIDERS = {provider.provider_id: provider for provider in LLM_PROVIDER_REGISTRY}
if len(LLM_PROVIDERS) != len(LLM_PROVIDER_REGISTRY):
raise RuntimeError("duplicate LLM provider id in registry")
def get_llm_provider(provider_id: str) -> LLMProviderSpec | None:
return LLM_PROVIDERS.get((provider_id or "").lower())
def normalize_provider_override(value: str | None, default_value: str | None) -> str:
"""
只保留与 Registry 默认值不同的用户覆盖值。
WebUI 需要把默认值展示在输入框中,但不能因此把默认值固化到 config.toml;
否则后续升级 Registry 默认模型或地址时,旧配置会继续覆盖新默认值。
"""
normalized_value = (value or "").strip()
normalized_default = (default_value or "").strip()
if normalized_value == normalized_default:
return ""
return normalized_value