DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.
Python ai-agentsai-tutorclawbotcli-tooldeepresearchinteractive-learninglearningmulti-agent-systemsrag
feat: add API Route LLM gateway provider
dennyho09178972c8786afe
diff --git a/README.md b/README.mdindex ac0f77733..730ffecb9 100644--- a/README.md+++ b/README.md@@ -570,6 +570,8 @@ and their subdomains; `blocked_domains` always takes precedence.Project-root `.env` is **not** read as an application config file. For a minimal model setup, save a Base URL and API key in **Settings → Providers**, then add and select an LLM in **Language models**. Add an embedding profile only if you plan to use Knowledge Base / RAG features.+For API Route, select **API Route** in **Settings → Providers** and enter an API Route key. The preset uses `https://global.api-route.com/v1`; then add a model using its API Route model ID in **Language models**. See the [API Route quickstart](https://www.api-route.com/docs/quickstart) for key and model setup.+LLM and task-model profiles expose an **API format** setting when their providersupports a choice. Keep `Auto` for normal routing and fallback, or choose`OpenAI Chat Completions`, `OpenAI Responses`, or `Anthropic Messages`; forceddiff --git a/deeptutor/services/provider_registry.py b/deeptutor/services/provider_registry.pyindex 4e7c443af..ba6e5de63 100644--- a/deeptutor/services/provider_registry.py+++ b/deeptutor/services/provider_registry.py@@ -156,6 +156,7 @@ PROVIDER_ALIASES = {"orca_router": "orcarouter","orca-router": "orcarouter","cheaper_inference": "cheaperinference",+ "api route": "api_route",}@@ -309,6 +310,16 @@ PROVIDERS: tuple[ProviderSpec, ...] = (detect_by_base_keyword="cheaperinference",default_api_base="https://api.cheaperinference.com/v1",),+ ProviderSpec(+ name="api_route",+ keywords=("api_route", "api-route", "api route"),+ env_key="API_ROUTE_API_KEY",+ display_name="API Route",+ backend="openai_compat",+ is_gateway=True,+ detect_by_base_keyword="api-route.com",+ default_api_base="https://global.api-route.com/v1",+ ),ProviderSpec(name="volcengine",keywords=("volcengine", "volces", "ark"),diff --git a/tests/api/test_settings_router.py b/tests/api/test_settings_router.pyindex b107cccc3..3804447f7 100644--- a/tests/api/test_settings_router.py+++ b/tests/api/test_settings_router.py@@ -683,6 +683,13 @@ def test_llm_provider_choices_include_cheaperinference() -> None:assert llm["cheaperinference"]["base_url"] == "https://api.cheaperinference.com/v1"+def test_llm_provider_choices_include_api_route() -> None:+ llm = {item["value"]: item for item in settings_router._provider_choices()["llm"]}++ assert llm["api_route"]["label"] == "API Route"+ assert llm["api_route"]["base_url"] == "https://global.api-route.com/v1"++def test_llm_provider_choices_include_novita() -> None:llm = {item["value"]: item for item in settings_router._provider_choices()["llm"]}diff --git a/tests/core/test_agentic_client_provider_kwargs.py b/tests/core/test_agentic_client_provider_kwargs.pyindex aae8ab631..a1e2279bf 100644--- a/tests/core/test_agentic_client_provider_kwargs.py+++ b/tests/core/test_agentic_client_provider_kwargs.py@@ -558,6 +558,7 @@ def test_registered_cloud_openai_compat_providers_enable_native_tools() -> None:"atlascloud","unifically","cheaperinference",+ "api_route","edenai","novita","volcengine_coding_plan",diff --git a/tests/services/config/test_provider_runtime.py b/tests/services/config/test_provider_runtime.pyindex 52934629b..6818478b3 100644--- a/tests/services/config/test_provider_runtime.py+++ b/tests/services/config/test_provider_runtime.py@@ -346,6 +346,51 @@ def test_llm_cheaperinference_base_url_detection_preserves_openai_binding_compatassert resolved.effective_url == "https://api.cheaperinference.com/v1"+def test_llm_api_route_binding_uses_default_openai_compatible_endpoint() -> None:+ catalog = _build_catalog(+ llm_profile={+ "id": "llm-p",+ "name": "API Route",+ "binding": "api_route",+ "base_url": "",+ "api_key": "api-route-key",+ "api_version": "",+ "extra_headers": {},+ "models": [{"id": "llm-m", "name": "GPT", "model": "gpt-5.5"}],+ }+ )++ resolved = resolve_llm_runtime_config(catalog=catalog)++ assert resolved.provider_name == "api_route"+ assert resolved.provider_mode == "gateway"+ assert resolved.binding == "api_route"+ assert resolved.model == "gpt-5.5"+ assert resolved.api_key == "api-route-key"+ assert resolved.effective_url == "https://global.api-route.com/v1"+++def test_llm_api_route_base_url_detection_preserves_openai_binding_compatibility() -> None:+ catalog = _build_catalog(+ llm_profile={+ "id": "llm-p",+ "name": "OpenAI Compatible",+ "binding": "openai",+ "base_url": "https://global.api-route.com/v1",+ "api_key": "api-route-key",+ "api_version": "",+ "extra_headers": {},+ "models": [{"id": "llm-m", "name": "GPT", "model": "gpt-5.5"}],+ }+ )++ resolved = resolve_llm_runtime_config(catalog=catalog)++ assert resolved.provider_name == "api_route"+ assert resolved.provider_mode == "gateway"+ assert resolved.effective_url == "https://global.api-route.com/v1"++def test_llm_novita_binding_uses_default_openai_compatible_endpoint() -> None:catalog = _build_catalog(llm_profile={diff --git a/tests/services/test_provider_registry.py b/tests/services/test_provider_registry.pyindex 829a6e6d7..a01e0b4de 100644--- a/tests/services/test_provider_registry.py+++ b/tests/services/test_provider_registry.py@@ -79,6 +79,20 @@ def test_cheaperinference_provider_aliases_and_base_detection() -> None:assert find_gateway(api_base="https://api.cheaperinference.com/v1") == spec+def test_api_route_provider_aliases_and_base_detection() -> None:+ spec = find_by_name("api_route")++ assert spec is not None+ assert spec.display_name == "API Route"+ assert spec.env_key == "API_ROUTE_API_KEY"+ assert spec.backend == "openai_compat"+ assert spec.mode == "gateway"+ assert spec.default_api_base == "https://global.api-route.com/v1"+ assert find_by_name("api-route") == spec+ assert find_by_name("API Route") == spec+ assert find_gateway(api_base="https://global.api-route.com/v1") == spec++def test_openai_codex_is_not_detected_from_api_base() -> None:assert find_gateway(api_base="https://codex.example.com/v1") is None