Skip to content

利用 AI 大模型和自动化工作流,根据主题或关键词一键生成高清短视频。Generate HD short videos from a topic or keyword with an automated AI workflow.

fix(webui): distinguish Kimi API platforms

harry0703d4c0e45da4ac
diff --git a/app/models/llm_provider.py b/app/models/llm_provider.py
index 3a29a44f..8f57c3d6 100644
--- a/app/models/llm_provider.py
+++ b/app/models/llm_provider.py
@@ -15,6 +15,17 @@ class LLMProviderField:
default_value: str = ""
+@dataclass(frozen=True, slots=True)
+class LLMProviderEndpoint:
+ """描述同一 Provider 在不同服务区域使用的配套入口和 API 地址。"""
+
+ endpoint_id: str
+ default_label: str
+ base_url: str
+ api_key_url: str
+ model_docs_url: str = ""
+
+
@dataclass(frozen=True, slots=True)
class LLMProviderSpec:
"""
@@ -29,7 +40,6 @@ class LLMProviderSpec:
default_label: str
adapter: str = "openai_compatible"
api_key_url: str = ""
- international_api_key_url: str = ""
default_model: str = ""
default_base_url: str = ""
requires_api_key: bool = True
@@ -40,6 +50,9 @@ class LLMProviderSpec:
deprecated_models: tuple[str, ...] = ()
deprecated_base_urls: tuple[str, ...] = ()
extra_fields: tuple[LLMProviderField, ...] = ()
+ service_endpoints: tuple[LLMProviderEndpoint, ...] = ()
+ default_service_endpoint_id: str = ""
+ international_service_endpoint_id: str = ""
@property
def label_key(self) -> str:
@@ -49,6 +62,21 @@ class LLMProviderSpec:
def tips_key(self) -> str:
return f"llm_provider_tips.{self.provider_id}"
+ @property
+ def endpoint_selector_label_key(self) -> str:
+ return f"llm_provider_endpoint_selector.{self.provider_id}"
+
+ @property
+ def endpoint_selector_help_key(self) -> str:
+ return f"llm_provider_endpoint_selector_help.{self.provider_id}"
+
+ @property
+ def authentication_error_key(self) -> str:
+ return f"llm_provider_authentication_error.{self.provider_id}"
+
+ def endpoint_label_key(self, endpoint_id: str) -> str:
+ return f"llm_provider_endpoint.{self.provider_id}.{endpoint_id}"
+
def config_key(self, suffix: str) -> str:
return f"{self.provider_id}_{suffix}"
@@ -64,9 +92,94 @@ class LLMProviderSpec:
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 self.effective_default_base_url
return base_url
+ def get_service_endpoint(self, endpoint_id: str) -> LLMProviderEndpoint | None:
+ """按稳定 ID 获取服务区域,避免业务逻辑依赖可变化的推广链接。"""
+ return next(
+ (
+ endpoint
+ for endpoint in self.service_endpoints
+ if endpoint.endpoint_id == endpoint_id
+ ),
+ None,
+ )
+
+ @property
+ def default_service_endpoint(self) -> LLMProviderEndpoint | None:
+ """返回 Provider 声明的默认服务区域。"""
+ return self.get_service_endpoint(self.default_service_endpoint_id)
+
+ @property
+ def international_service_endpoint(self) -> LLMProviderEndpoint | None:
+ """返回 Provider 声明的国际服务区域。"""
+ return self.get_service_endpoint(self.international_service_endpoint_id)
+
+ @property
+ def effective_default_base_url(self) -> str:
+ """优先从默认服务区域读取 Base URL,普通 Provider 仍使用原字段。"""
+ endpoint = self.default_service_endpoint
+ return endpoint.base_url if endpoint else self.default_base_url
+
+ def preferred_service_endpoint(
+ self, *, prefer_international: bool
+ ) -> LLMProviderEndpoint | None:
+ """根据界面区域返回首选入口,缺少国际入口时安全回退默认入口。"""
+ if prefer_international and self.international_service_endpoint:
+ return self.international_service_endpoint
+ return self.default_service_endpoint
+
+ def effective_api_key_url(self, *, prefer_international: bool = False) -> str:
+ """统一解析 API Key 申请入口,避免 Endpoint Provider 重复维护链接。"""
+ endpoint = self.preferred_service_endpoint(
+ prefer_international=prefer_international
+ )
+ return endpoint.api_key_url if endpoint else self.api_key_url
+
+ def find_service_endpoint(
+ self, configured_base_url: str | None
+ ) -> LLMProviderEndpoint | None:
+ """根据已保存的 Base URL 识别 Provider 的标准服务区域。"""
+ normalized_url = (configured_base_url or "").strip().rstrip("/")
+ if not normalized_url:
+ return None
+ return next(
+ (
+ endpoint
+ for endpoint in self.service_endpoints
+ if endpoint.base_url.rstrip("/") == normalized_url
+ ),
+ None,
+ )
+
+ def select_service_endpoint(
+ self,
+ configured_base_url: str | None,
+ *,
+ has_api_key: bool,
+ prefer_international: bool,
+ ) -> LLMProviderEndpoint | None:
+ """
+ 选择 WebUI 应展示的标准服务区域。
+
+ 已明确保存的标准地址优先;未知地址保留为自定义。历史配置可能只有
+ API Key 而没有 Base URL,这类用户继续使用 Registry 默认区域,避免
+ 升级后因界面语言不同而切换服务。只有全新配置才根据界面语言选择
+ 国际入口。
+ """
+ configured_url = (configured_base_url or "").strip()
+ if configured_url:
+ return self.find_service_endpoint(configured_url)
+
+ default_endpoint = self.default_service_endpoint
+ if has_api_key or not prefer_international:
+ return default_endpoint
+
+ return self.preferred_service_endpoint(
+ prefer_international=prefer_international
+ )
+
# 元组顺序就是 WebUI 下拉框顺序。新增普通 OpenAI-compatible Provider 时,
# 通常只需要在这里增加一项并补充 locale;只有协议不同的 Provider 才需要在
@@ -76,18 +189,41 @@ LLM_PROVIDER_REGISTRY = (
LLMProviderSpec(
"moonshot",
"Kimi / Moonshot AI",
- api_key_url=(
- "https://platform.kimi.com?"
- "track_id=track-2f5441d6ffd84c509dd079d78e9db5dc&"
- "aff=moneyprinterturbo"
- ),
- international_api_key_url=(
- "https://platform.kimi.ai?"
- "track_id=track-f6b0a640d35c41deb03b247242a1058c&"
- "aff=moneyprinterturbo"
- ),
default_model="kimi-k3",
- default_base_url="https://api.moonshot.cn/v1",
+ service_endpoints=(
+ LLMProviderEndpoint(
+ endpoint_id="china",
+ default_label="China",
+ base_url="https://api.moonshot.cn/v1",
+ api_key_url=(
+ "https://platform.kimi.com?"
+ "track_id=track-2f5441d6ffd84c509dd079d78e9db5dc&"
+ "aff=moneyprinterturbo"
+ ),
+ model_docs_url=(
+ "https://platform.kimi.com/docs/models?"
+ "track_id=track-2f5441d6ffd84c509dd079d78e9db5dc&"
+ "aff=moneyprinterturbo"
+ ),
+ ),
+ LLMProviderEndpoint(
+ endpoint_id="global",
+ default_label="Global",
+ base_url="https://api.moonshot.ai/v1",
+ api_key_url=(
+ "https://platform.kimi.ai?"
+ "track_id=track-f6b0a640d35c41deb03b247242a1058c&"
+ "aff=moneyprinterturbo"
+ ),
+ model_docs_url=(
+ "https://platform.kimi.ai/docs/models?"
+ "track_id=track-f6b0a640d35c41deb03b247242a1058c&"
+ "aff=moneyprinterturbo"
+ ),
+ ),
+ ),
+ default_service_endpoint_id="china",
+ international_service_endpoint_id="global",
),
# 主流模型原厂与云厂商
LLMProviderSpec(
diff --git a/test/services/test_llm.py b/test/services/test_llm.py
index d377ed79..cc1663c3 100644
--- a/test/services/test_llm.py
+++ b/test/services/test_llm.py
@@ -5,6 +5,7 @@ import tempfile
import tomllib
import types
import unittest
+from dataclasses import replace
from pathlib import Path
from unittest.mock import patch
@@ -396,10 +397,16 @@ class TestLiteLLMProvider(unittest.TestCase):
tips = translations.get(provider.tips_key, "")
if not tips:
continue
+ default_endpoint = provider.default_service_endpoint
rendered = tips.format(
- api_key_url=provider.api_key_url,
+ api_key_url=provider.effective_api_key_url(),
default_model=provider.default_model,
- default_base_url=provider.default_base_url,
+ default_base_url=provider.effective_default_base_url,
+ model_docs_url=(
+ default_endpoint.model_docs_url
+ if default_endpoint
+ else ""
+ ),
docker_hint="",
**{
f"default_{field.config_suffix}": field.default_value
@@ -441,19 +448,26 @@ class TestLiteLLMProvider(unittest.TestCase):
for provider in LLM_PROVIDER_REGISTRY:
if provider.requires_api_key:
- self.assertTrue(provider.api_key_url, provider.provider_id)
+ api_key_url = provider.effective_api_key_url()
+ self.assertTrue(api_key_url, provider.provider_id)
self.assertTrue(
- provider.api_key_url.startswith("https://"),
+ api_key_url.startswith("https://"),
provider.provider_id,
)
for language, translations in locale_translations.items():
tips_template = translations.get(provider.tips_key, "")
if not tips_template:
continue
+ default_endpoint = provider.default_service_endpoint
tips = tips_template.format(
- api_key_url=provider.api_key_url,
+ api_key_url=api_key_url,
default_model=provider.default_model,
- default_base_url=provider.default_base_url,
+ default_base_url=provider.effective_default_base_url,
+ model_docs_url=(
+ default_endpoint.model_docs_url
+ if default_endpoint
+ else ""
+ ),
docker_hint="",
**{
f"default_{field.config_suffix}": field.default_value
@@ -465,11 +479,99 @@ class TestLiteLLMProvider(unittest.TestCase):
)
self.assertIn("](", api_key_line, provider.provider_id)
self.assertIn(
- f"]({provider.api_key_url})",
+ f"]({api_key_url})",
api_key_line,
f"{language}: {provider.provider_id}",
)
+ def test_service_endpoint_registry_references_valid_stable_ids(self):
+ """服务区域必须通过唯一稳定 ID 关联,不能依赖链接或展示文案。"""
+ for provider in LLM_PROVIDER_REGISTRY:
+ endpoint_ids = [
+ endpoint.endpoint_id for endpoint in provider.service_endpoints
+ ]
+ self.assertEqual(
+ len(endpoint_ids),
+ len(set(endpoint_ids)),
+ provider.provider_id,
+ )
+ if not endpoint_ids:
+ self.assertFalse(provider.default_service_endpoint_id)
+ self.assertFalse(provider.international_service_endpoint_id)
+ continue
+
+ self.assertIn(provider.default_service_endpoint_id, endpoint_ids)
+ if provider.international_service_endpoint_id:
+ self.assertIn(provider.international_service_endpoint_id, endpoint_ids)
+
+ def test_kimi_service_endpoint_selection_preserves_existing_configs(self):
+ """已有 Kimi 配置不能因界面语言变化而被静默切换到另一套账号体系。"""
+ provider = get_llm_provider("moonshot")
+
+ china = provider.select_service_endpoint(
+ "",
+ has_api_key=True,
+ prefer_international=True,
+ )
+ global_endpoint = provider.select_service_endpoint(
+ "https://api.moonshot.ai/v1/",
+ has_api_key=True,
+ prefer_international=False,
+ )
+
+ self.assertEqual(china.endpoint_id, "china")
+ self.assertEqual(global_endpoint.endpoint_id, "global")
+ self.assertIsNone(
+ provider.select_service_endpoint(
+ "https://gateway.example.com/v1",
+ has_api_key=True,
+ prefer_international=True,
+ )
+ )
+
+ def test_kimi_fresh_config_uses_interface_region(self):
+ """新配置按界面语言推荐站点,但仍由用户在 WebUI 中明确选择。"""
+ provider = get_llm_provider("moonshot")
+
+ china = provider.select_service_endpoint(
+ "",
+ has_api_key=False,
+ prefer_international=False,
+ )
+ global_endpoint = provider.select_service_endpoint(
+ "",
+ has_api_key=False,
+ prefer_international=True,
+ )
+
+ self.assertEqual(china.base_url, "https://api.moonshot.cn/v1")
+ self.assertEqual(global_endpoint.base_url, "https://api.moonshot.ai/v1")
+ self.assertIn("platform.kimi.ai", global_endpoint.api_key_url)
+
+ def test_kimi_endpoint_selection_does_not_depend_on_marketing_url(self):
+ """更新推广参数不能改变国际站的业务选择结果。"""
+ provider = get_llm_provider("moonshot")
+ global_endpoint = replace(
+ provider.international_service_endpoint,
+ api_key_url="https://platform.kimi.ai/?new-tracking=1",
+ )
+ updated_provider = replace(
+ provider,
+ service_endpoints=tuple(
+ global_endpoint if endpoint.endpoint_id == "global" else endpoint
+ for endpoint in provider.service_endpoints
+ ),
+ )
+
+ selected = updated_provider.select_service_endpoint(
+ "",
+ has_api_key=False,
+ prefer_international=True,
+ )
+
+ self.assertEqual(selected.endpoint_id, "global")
+ self.assertEqual(selected.api_key_url, global_endpoint.api_key_url)
+
def test_example_config_does_not_duplicate_registry_defaults(self):
"""示例配置只保存用户覆盖值,默认模型和地址由 Registry 唯一维护。"""
config_path = Path(__file__).parent.parent.parent / "config.example.toml"
@@ -482,7 +584,7 @@ class TestLiteLLMProvider(unittest.TestCase):
"",
provider.provider_id,
)
- if provider.default_base_url:
+ if provider.effective_default_base_url:
self.assertEqual(
app_config.get(provider.config_key("base_url"), ""),
"",
diff --git a/test/services/test_webui_i18n.py b/test/services/test_webui_i18n.py
index 34d34870..0744df07 100644
--- a/test/services/test_webui_i18n.py
+++ b/test/services/test_webui_i18n.py
@@ -30,6 +30,13 @@ ENGLISH_FALLBACK_KEYS = frozenset(
"Confirm AI Video Charge",
"Confirm AI Video Charge Help",
"Confirm AI Video Charge Required",
+ "Custom API Endpoint",
+ "API Platform",
+ "llm_provider_endpoint_selector.moonshot",
+ "llm_provider_endpoint_selector_help.moonshot",
+ "llm_provider_endpoint.moonshot.china",
+ "llm_provider_endpoint.moonshot.global",
+ "llm_provider_authentication_error.moonshot",
"Local LLM Script Generation",
"llm_provider_label.shengsuanyun",
"LoomLoom Poll Retry Pending",
@@ -146,8 +153,8 @@ class TestWebuiI18n(unittest.TestCase):
tips = _load_translation(locale)["llm_provider_tips.shengsuanyun"]
provider = get_llm_provider("shengsuanyun")
rendered = tips.format(
- api_key_url=provider.api_key_url,
- default_base_url=provider.default_base_url,
+ api_key_url=provider.effective_api_key_url(),
+ default_base_url=provider.effective_default_base_url,
default_model=provider.default_model,
)
self.assertEqual(_markdown_urls(rendered), expected_urls)
diff --git a/test/services/test_webui_llm_settings.py b/test/services/test_webui_llm_settings.py
new file mode 100644
index 00000000..9ec70454
--- /dev/null
+++ b/test/services/test_webui_llm_settings.py
@@ -0,0 +1,97 @@
+from pathlib import Path
+from unittest.mock import patch
+
+from streamlit.testing.v1 import AppTest
+
+from app.config import config
+from app.services import llm
+
+
+ROOT_DIR = Path(__file__).parent.parent.parent
+WEBUI_MAIN = ROOT_DIR / "webui" / "Main.py"
+
+
+def _widget_by_key(elements, key):
+ return next(
+ item
+ for item in elements
+ if str(getattr(item, "key", "")) == key
+ or str(getattr(item, "key", "")).startswith(f"{key}_")
+ )
+
+
+def test_kimi_platform_selection_keeps_endpoint_configuration_consistent():
+ """Kimi 平台切换必须同步 Base URL,并只允许自定义模式编辑地址。"""
+ app_config = dict(
+ config.app,
+ llm_provider="moonshot",
+ moonshot_api_key="",
+ moonshot_base_url="",
+ moonshot_model_name="",
+ )
+ ui_config = dict(config.ui, language="en")
+
+ with (
+ patch.object(config, "app", app_config),
+ patch.object(config, "ui", ui_config),
+ patch.object(config, "try_save_config", return_value=True),
+ patch.object(
+ llm,
+ "test_connection",
+ return_value=(False, "401 Invalid Authentication", 0.1),
+ ),
+ ):
+ app = AppTest.from_file(str(WEBUI_MAIN), default_timeout=60)
+ app.session_state["ui_language"] = "en"
+ app.session_state["settings_dialog_open"] = True
+ app.run()
+
+ assert [str(item.value) for item in app.exception] == []
+ endpoint_select = _widget_by_key(
+ app.selectbox,
+ "moonshot_service_endpoint_select",
+ )
+ global_base_url = _widget_by_key(
+ app.text_input,
+ "moonshot_base_url_global_input",
+ )
+ assert endpoint_select.value == "global"
+ assert global_base_url.value == "https://api.moonshot.ai/v1"
+ assert global_base_url.disabled is True
+ assert app_config["moonshot_base_url"] == "https://api.moonshot.ai/v1"
+
+ endpoint_select.set_value("china").run()
+ china_base_url = _widget_by_key(
+ app.text_input,
+ "moonshot_base_url_china_input",
+ )
+ assert china_base_url.value == "https://api.moonshot.cn/v1"
+ assert china_base_url.disabled is True
+ # 中国站是 Registry 的兼容默认值,不应重复写入用户配置。
+ assert app_config["moonshot_base_url"] == ""
+
+ endpoint_select = _widget_by_key(
+ app.selectbox,
+ "moonshot_service_endpoint_select",
+ )
+ endpoint_select.set_value("custom").run()
+ custom_base_url = _widget_by_key(
+ app.text_input,
+ "moonshot_base_url_custom_input",
+ )
+ assert custom_base_url.value == ""
+ assert custom_base_url.disabled is False
+ custom_base_url.set_value("https://gateway.example.com/v1").run()
+ assert app_config["moonshot_base_url"] == "https://gateway.example.com/v1"
+
+ endpoint_select = _widget_by_key(
+ app.selectbox,
+ "moonshot_service_endpoint_select",
+ )
+ endpoint_select.set_value("global").run()
+ _widget_by_key(app.button, "test_llm_connection_button").click().run()
+ error_messages = [str(item.value) for item in app.error]
+ assert any("platform.kimi.ai" in message for message in error_messages)
+ assert any("api.moonshot.ai" in message for message in error_messages)
+ assert any("401 Invalid Authentication" in message for message in error_messages)
+
diff --git a/webui/Main.py b/webui/Main.py
index 1f06489a..0da3ba6d 100644
--- a/webui/Main.py
+++ b/webui/Main.py
@@ -93,6 +93,7 @@ DEFAULT_CHATTERBOX_BASE_URL = "http://127.0.0.1:4123/v1"
DEFAULT_CHATTERBOX_MODEL = "chatterbox"
DEFAULT_CHATTERBOX_VOICES = ["default-Female"]
ONBOARDING_TOUR_KEY = "mpt-onboarding-v1"
+CUSTOM_LLM_ENDPOINT_ID = "custom"
VOICE_MODE_TTS = "tts"
VOICE_MODE_UPLOAD = "upload"
VOICE_MODE_NONE = "none"
@@ -1727,14 +1728,23 @@ def get_llm_provider_tips(provider_id, **kwargs):
if not tips:
return tips
+ service_endpoint = provider.preferred_service_endpoint(
+ prefer_international=tips_language == "en"
+ )
+ api_key_url = (
+ service_endpoint.api_key_url
+ if service_endpoint
+ else provider.effective_api_key_url()
+ )
format_context = {
- "api_key_url": (
- provider.international_api_key_url
- if tips_language == "en" and provider.international_api_key_url
- else provider.api_key_url
- ),
+ "api_key_url": api_key_url,
"default_model": provider.default_model,
- "default_base_url": provider.default_base_url,
+ "default_base_url": (
+ service_endpoint.base_url
+ if service_endpoint
+ else provider.effective_default_base_url
+ ),
+ "model_docs_url": service_endpoint.model_docs_url if service_endpoint else "",
**{
f"default_{field.config_suffix}": field.default_value
for field in provider.extra_fields
@@ -1748,6 +1758,32 @@ def get_llm_provider_tips(provider_id, **kwargs):
return tips
+def format_llm_connection_error(provider_id, base_url, error):
+ """为可明确定位的鉴权错误补充配置检查建议,同时保留原始响应。"""
+ error_text = str(error or "").strip()
+ normalized_error = error_text.lower()
+ authentication_markers = (
+ "401",
+ "authentication",
+ "invalid api key",
+ "invalid_api_key",
+ "unauthorized",
+ )
+ provider = get_llm_provider(provider_id)
+ if provider is None or not provider.service_endpoints or not any(
+ marker in normalized_error for marker in authentication_markers
+ ):
+ return error_text
+
+ message = tr_optional(
+ provider.authentication_error_key,
+ fallback_language="en",
+ )
+ if not message:
+ return error_text
+ return message.format(base_url=base_url or "-", error=error_text)
+
+
def get_llm_provider_label(provider):
return tr_optional(provider.label_key) or provider.default_label
@@ -2169,16 +2205,95 @@ def _render_settings_dialog():
raise RuntimeError(f"unsupported llm provider: {llm_provider}")
llm_api_key = config.app.get(llm_provider_spec.config_key("api_key"), "")
- llm_base_url = (
- config.app.get(llm_provider_spec.config_key("base_url"), "")
- or llm_provider_spec.default_base_url
+ configured_llm_base_url = config.app.get(
+ llm_provider_spec.config_key("base_url"), ""
)
- llm_default_base_url = llm_provider_spec.default_base_url
+ llm_default_base_url = llm_provider_spec.effective_default_base_url
+ llm_base_url = configured_llm_base_url or llm_default_base_url
llm_model_name = llm_provider_spec.resolve_model_name(
config.app.get(llm_provider_spec.config_key("model_name"), "")
)
provider_tip_context = {}
+ selected_service_endpoint = None
+ if llm_provider_spec.service_endpoints:
+ # Kimi 等 Provider 的中国站和国际站使用不同账号体系。只让用户
+ # 选择服务区域,再由 Registry 同步 API 申请入口和 Base URL,
+ # 避免手工组合错误。已有空 Base URL 配置继续沿用中国站,只有
+ # 尚未填写 Key 的全新配置才根据界面语言推荐对应入口。
+ selected_service_endpoint = (
+ llm_provider_spec.select_service_endpoint(
+ configured_llm_base_url,
+ has_api_key=bool(str(llm_api_key).strip()),
+ prefer_international=(
+ st.session_state.get("ui_language", "en") != "zh"
+ ),
+ )
+ )
+ endpoint_options = [
+ endpoint.endpoint_id
+ for endpoint in llm_provider_spec.service_endpoints
+ ] + [CUSTOM_LLM_ENDPOINT_ID]
+ default_endpoint_id = (
+ selected_service_endpoint.endpoint_id
+ if selected_service_endpoint
+ else CUSTOM_LLM_ENDPOINT_ID
+ )
+ endpoint_labels = {
+ endpoint.endpoint_id: (
+ tr_optional(
+ llm_provider_spec.endpoint_label_key(endpoint.endpoint_id),
+ fallback_language="en",
+ )
+ or endpoint.default_label
+ )
+ for endpoint in llm_provider_spec.service_endpoints
+ }
+ endpoint_labels[CUSTOM_LLM_ENDPOINT_ID] = (
+ tr_optional("Custom API Endpoint", fallback_language="en")
+ or "Custom API Endpoint"
+ )
+ with llm_form_panel:
+ selected_endpoint_id = stable_selectbox(
+ tr_optional(
+ llm_provider_spec.endpoint_selector_label_key,
+ fallback_language="en",
+ )
+ or tr("API Platform"),
+ options=endpoint_options,
+ default_value=default_endpoint_id,
+ key=f"{llm_provider}_service_endpoint_select",
+ format_func=lambda endpoint_id: endpoint_labels[endpoint_id],
+ help=(
+ tr_optional(
+ llm_provider_spec.endpoint_selector_help_key,
+ fallback_language="en",
+ )
+ or None
+ ),
+ )
+ selected_service_endpoint = next(
+ (
+ endpoint
+ for endpoint in llm_provider_spec.service_endpoints
+ if endpoint.endpoint_id == selected_endpoint_id
+ ),
+ None,
+ )
+ if selected_service_endpoint:
+ llm_base_url = selected_service_endpoint.base_url
+ provider_tip_context.update(
+ {
+ "api_key_url": selected_service_endpoint.api_key_url,
+ "default_base_url": selected_service_endpoint.base_url,
+ "model_docs_url": selected_service_endpoint.model_docs_url,
+ }
+ )
+ else:
+ # 自定义模式只保留用户明确保存的地址,不将某个标准区域伪装
+ # 成自定义值。输入为空时配置不会持久化,下一次仍回到兼容默认。
+ llm_base_url = str(configured_llm_base_url or "").strip()
+
if llm_provider == "ollama":
llm_default_base_url = config.get_default_ollama_base_url()
if not llm_base_url:
@@ -2210,7 +2325,13 @@ def _render_settings_dialog():
st_llm_base_url = llm_form_panel.text_input(
tr("Base Url"),
value=llm_base_url,
- key=f"{llm_provider}_base_url_input",
+ key=(
+ f"{llm_provider}_base_url_"
+ f"{selected_service_endpoint.endpoint_id}_input"
+ if selected_service_endpoint
+ else f"{llm_provider}_base_url_custom_input"
+ ),
+ disabled=selected_service_endpoint is not None,
)
st_llm_model_name = ""
if llm_provider == "groq":
@@ -2320,6 +2441,11 @@ def _render_settings_dialog():
)
)
else:
+ connection_error = format_llm_connection_error(
+ llm_provider,
+ st_llm_base_url,
+ connection_error,
+ )
llm_form_panel.error(
tr("LLM Connection Test Failed").format(error=connection_error)
)
diff --git a/webui/i18n/en.json b/webui/i18n/en.json
index f4c2cfc4..61ff5b69 100644
--- a/webui/i18n/en.json
+++ b/webui/i18n/en.json
@@ -315,6 +315,13 @@
"Video Encoder": "Video Encoder",
"Default Video Encoder": "Default (Recommended)",
"Video Encoder Help": "Advanced option. Default follows the app's stable encoder policy, currently libx264. If a selected hardware encoder is unavailable, the app automatically falls back to libx264.",
+ "API Platform": "API Platform",
+ "Custom API Endpoint": "Custom Endpoint",
+ "llm_provider_endpoint_selector.moonshot": "Kimi API Platform",
+ "llm_provider_endpoint_selector_help.moonshot": "Select the platform where your API Key was created. China and Global accounts use different API endpoints.",
+ "llm_provider_endpoint.moonshot.china": "China",
+ "llm_provider_endpoint.moonshot.global": "Global",
+ "llm_provider_authentication_error.moonshot": "Authentication failed. Make sure the API Key matches the selected Kimi platform. China uses platform.kimi.com with api.moonshot.cn; Global uses platform.kimi.ai with api.moonshot.ai. Current Base URL: {base_url}. Provider response: {error}",
"llm_provider_tips.ollama": "##### Ollama Configuration\n- **API Key**: not required\n- **Base Url**: usually `http://localhost:11434/v1` for local runs or `http://host.docker.internal:11434/v1` for Docker{docker_hint}\n- **Model Name**: required; run `ollama list` and enter an installed model, such as `qwen:7b`",
"llm_provider_tips.ollama.docker_hint": "\n > Container environment detected. If Base Url is empty, `http://host.docker.internal:11434/v1` is used by default.\n",
"llm_provider_tips.openai": "##### OpenAI Configuration\n- **API Key**: create one on the [OpenAI Platform]({api_key_url})\n- **Base Url**: defaults to `{default_base_url}`; enter another endpoint when using a compatible service\n- **Model Name**: defaults to `{default_model}`; you can also enter another model ID available to your account\n> Accessing the official service may require a network proxy in some regions",
@@ -323,7 +330,7 @@
"llm_provider_tips.aimlapi": "##### AIML API Configuration\n- **API Key**: create one at [AIML API]({api_key_url})\n- **Base Url**: defaults to `{default_base_url}`\n- **Model Name**: defaults to `{default_model}`; you can also enter another supported model ID",
"llm_provider_tips.evolink": "##### EvoLink Configuration\n- **API Key**: create one on [EvoLink]({api_key_url})\n- **Base Url**: defaults to `{default_base_url}`\n- **Model Name**: defaults to `{default_model}`; you can also enter another supported model ID",
"llm_provider_tips.volcengine": "##### VolcEngine Ark Configuration\n- **API Key**: create one in the Ark console; [register on VolcEngine]({api_key_url})\n- **Base Url**: defaults to `{default_base_url}`\n- **Model Name**: defaults to `{default_model}`; make sure the model is enabled in your Ark account",
- "llm_provider_tips.moonshot": "##### Kimi / Moonshot Configuration\n- **API Key**: register through the [MoneyPrinterTurbo link (10% bonus API credit on your first top-up)]({api_key_url}) and create one in the console\n- **Base Url**: defaults to `{default_base_url}`\n- **Model Name**: defaults to `{default_model}`; see the [model list](https://platform.kimi.ai/docs/models?track_id=track-f6b0a640d35c41deb03b247242a1058c&aff=moneyprinterturbo)\n\nWhy recommended:\n- **Fits the video creation workflow**: helps generate scripts, extract stock-footage search keywords, and improve final footage relevance\n- **Strong long-context capability**: useful for longer topics, batch scripts, and complex prompts\n- **Exclusive offer for new users**: receive bonus API credit equal to 10% of the first successful top-up, up to CNY 1,000; offer ends September 30, 2026",
+ "llm_provider_tips.moonshot": "##### Kimi / Moonshot Configuration\n- **API Key**: register through the [MoneyPrinterTurbo link (10% bonus API credit on your first top-up)]({api_key_url}) and create one in the console\n- **Base Url**: defaults to `{default_base_url}`\n- **Model Name**: defaults to `{default_model}`; see the [model list]({model_docs_url})\n\nWhy recommended:\n- **Fits the video creation workflow**: helps generate scripts, extract stock-footage search keywords, and improve final footage relevance\n- **Strong long-context capability**: useful for longer topics, batch scripts, and complex prompts\n- **Exclusive offer for new users**: receive bonus API credit equal to 10% of the first successful top-up, up to CNY 1,000; offer ends September 30, 2026",
"llm_provider_tips.oneapi": "##### OneAPI Configuration\n- **API Key**: create one in your own OneAPI deployment; see the [OneAPI project]({api_key_url})\n- **Base Url**: required; enter the OneAPI service endpoint\n- **Model Name**: required; enter a model ID configured in OneAPI",
"llm_provider_tips.qwen": "##### Qwen Configuration\n- **API Key**: create one on [DashScope]({api_key_url})\n- **Base Url**: not required\n- **Model Name**: defaults to `{default_model}`; see the [model list](https://help.aliyun.com/zh/dashscope/developer-reference/model-introduction#3ef6d0bcf91wy)",
"llm_provider_tips.azure": "##### Azure OpenAI Configuration\n- **API Key**: obtain one from the [Azure Portal]({api_key_url})\n- **Base Url**: required; enter the Azure OpenAI endpoint, such as `https://<resource>.openai.azure.com`\n- **Model Name**: enter the Deployment Name; see the [deployment guide](https://learn.microsoft.com/azure/ai-services/openai/how-to/create-resource)",
diff --git a/webui/i18n/zh.json b/webui/i18n/zh.json
index 0fdfa27c..48c4a803 100644
--- a/webui/i18n/zh.json
+++ b/webui/i18n/zh.json
@@ -315,6 +315,13 @@
"Video Encoder": "视频编码器",
"Default Video Encoder": "默认(推荐)",
"Video Encoder Help": "高级选项。“默认”跟随项目的稳定编码策略,当前使用 libx264;选择硬件编码器时,如果当前 FFmpeg、显卡或驱动不可用,会自动回退到 libx264。",
+ "API Platform": "API 平台",
+ "Custom API Endpoint": "自定义接口",
+ "llm_provider_endpoint_selector.moonshot": "Kimi API 平台",
+ "llm_provider_endpoint_selector_help.moonshot": "请选择 API Key 的创建平台。中国站和国际站使用不同的账号体系与 API 地址。",
+ "llm_provider_endpoint.moonshot.china": "中国站",
+ "llm_provider_endpoint.moonshot.global": "国际站",
+ "llm_provider_authentication_error.moonshot": "鉴权失败。请确认 API Key 与所选 Kimi 平台一致:中国站使用 platform.kimi.com 和 api.moonshot.cn,国际站使用 platform.kimi.ai 和 api.moonshot.ai。当前 Base URL:{base_url}。平台返回:{error}",
"llm_provider_tips.ollama": "##### Ollama 配置说明\n- **API Key**: 无需填写\n- **Base Url**: 本机运行时通常为 `http://localhost:11434/v1`;Docker 部署时通常为 `http://host.docker.internal:11434/v1`{docker_hint}\n- **Model Name**: 必填;运行 `ollama list` 查看本机已安装的模型,例如 `qwen:7b`",
"llm_provider_tips.ollama.docker_hint": "\n > 检测到容器环境,未配置 Base Url 时会默认使用 `http://host.docker.internal:11434/v1`\n",
"llm_provider_tips.openai": "##### OpenAI 配置说明\n- **API Key**: 在 [OpenAI Platform]({api_key_url}) 创建\n- **Base Url**: 默认 `{default_base_url}`;使用兼容服务时可填写对应地址\n- **Model Name**: 默认 `{default_model}`;也可以填写当前账号支持的其它模型 ID\n> 部分地区访问官方服务时可能需要配置网络代理",
@@ -323,7 +330,7 @@
"llm_provider_tips.aimlapi": "##### AIML API 配置说明\n- **API Key**: 在 [AIML API]({api_key_url}) 创建\n- **Base Url**: 默认 `{default_base_url}`\n- **Model Name**: 默认 `{default_model}`;也可以填写平台支持的其它模型 ID",
"llm_provider_tips.evolink": "##### EvoLink 配置说明\n- **API Key**: 在 [EvoLink]({api_key_url}) 创建\n- **Base Url**: 默认 `{default_base_url}`\n- **Model Name**: 默认 `{default_model}`;也可以填写平台支持的其它模型 ID",
"llm_provider_tips.volcengine": "##### VolcEngine Ark 配置说明\n- **API Key**: 在火山引擎方舟控制台创建;[点击注册火山引擎]({api_key_url})\n- **Base Url**: 默认 `{default_base_url}`\n- **Model Name**: 默认 `{default_model}`;请确保已在方舟控制台开通对应模型",
- "llm_provider_tips.moonshot": "##### Kimi / Moonshot 配置说明\n- **API Key**: 通过 [MoneyPrinterTurbo 专属链接(新用户首次充值赠送 10% API 额度)]({api_key_url}) 注册并在控制台创建\n- **Base Url**: 默认 `{default_base_url}`\n- **Model Name**: 默认 `{default_model}`;[查看模型列表](https://platform.kimi.com/docs/models?track_id=track-2f5441d6ffd84c509dd079d78e9db5dc&aff=moneyprinterturbo)\n\n推荐理由:\n- **视频创作链路匹配**: 可用于生成视频文案、提炼素材搜索关键词,并影响最终素材匹配效果\n- **长上下文能力强**: 适合处理较长主题、批量脚本和复杂提示词\n- **新用户专属优惠**: 首次成功充值可获充值金额 10% 的 API 额度,最高赠送 ¥1000,活动截至 2026 年 9 月 30 日",
+ "llm_provider_tips.moonshot": "##### Kimi / Moonshot 配置说明\n- **API Key**: 通过 [MoneyPrinterTurbo 专属链接(新用户首次充值赠送 10% API 额度)]({api_key_url}) 注册并在控制台创建\n- **Base Url**: 默认 `{default_base_url}`\n- **Model Name**: 默认 `{default_model}`;[查看模型列表]({model_docs_url})\n\n推荐理由:\n- **视频创作链路匹配**: 可用于生成视频文案、提炼素材搜索关键词,并影响最终素材匹配效果\n- **长上下文能力强**: 适合处理较长主题、批量脚本和复杂提示词\n- **新用户专属优惠**: 首次成功充值可获充值金额 10% 的 API 额度,最高赠送 ¥1000,活动截至 2026 年 9 月 30 日",
"llm_provider_tips.oneapi": "##### OneAPI 配置说明\n- **API Key**: 从您自己的 OneAPI 部署中创建;[查看 OneAPI 项目说明]({api_key_url})\n- **Base Url**: 必填;填写 OneAPI 服务地址\n- **Model Name**: 必填;填写 OneAPI 中已配置的模型 ID",
"llm_provider_tips.qwen": "##### Qwen 配置说明\n- **API Key**: 在 [DashScope]({api_key_url}) 创建\n- **Base Url**: 无需填写\n- **Model Name**: 默认 `{default_model}`;[查看模型列表](https://help.aliyun.com/zh/dashscope/developer-reference/model-introduction#3ef6d0bcf91wy)",
"llm_provider_tips.azure": "##### Azure OpenAI 配置说明\n- **API Key**: 在 [Azure Portal]({api_key_url}) 获取\n- **Base Url**: 必填;填写 Azure OpenAI Endpoint,例如 `https://<resource>.openai.azure.com`\n- **Model Name**: 填写实际的 Deployment Name;[查看部署说明](https://learn.microsoft.com/zh-cn/azure/ai-services/openai/how-to/create-resource)",