Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

feat: add API Route LLM gateway provider

dennyho09178972c8786afe
diff --git a/README.md b/README.md
index 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 provider
supports a choice. Keep `Auto` for normal routing and fallback, or choose
`OpenAI Chat Completions`, `OpenAI Responses`, or `Anthropic Messages`; forced
diff --git a/deeptutor/services/provider_registry.py b/deeptutor/services/provider_registry.py
index 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.py
index 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.py
index 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.py
index 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_compat
assert 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.py
index 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