Skip to content

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

Merge dev while preserving futureinfra and existing provider contracts

Bingxi Zhao (Frank)be4c144171d7
diff --cc deeptutor/services/provider_registry.py
index 10a7afd8a,ae6dbb86b..05a7bcaa0
--- a/deeptutor/services/provider_registry.py
+++ b/deeptutor/services/provider_registry.py
@@@ -156,7 -156,7 +156,8 @@@ PROVIDER_ALIASES =
"orca_router": "orcarouter",
"orca-router": "orcarouter",
"cheaper_inference": "cheaperinference",
+ "api route": "api_route",
+ "future_infra": "futureinfra",
}
@@@ -310,16 -310,26 +311,36 @@@ 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="requesty",
+ keywords=("requesty",),
+ env_key="REQUESTY_API_KEY",
+ display_name="Requesty",
+ backend="openai_compat",
+ is_gateway=True,
+ detect_by_base_keyword="requesty",
+ default_api_base="https://router.requesty.ai/v1",
+ ),
+ ProviderSpec(
+ name="futureinfra",
+ keywords=("futureinfra",),
+ env_key="FUTUREINFRA_API_KEY",
+ display_name="FutureInfra",
+ backend="openai_compat",
+ is_gateway=True,
+ detect_by_base_keyword="futureinfra",
+ default_api_base="https://futureinfra.ai/v1/ai",
+ ),
ProviderSpec(
name="volcengine",
keywords=("volcengine", "volces", "ark"),
diff --cc tests/api/test_settings_router.py
index 85dfb0db9,5a6b756bb..65aaa2a48
--- a/tests/api/test_settings_router.py
+++ b/tests/api/test_settings_router.py
@@@ -683,13 -683,20 +683,27 @@@ def test_llm_provider_choices_include_c
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_requesty() -> None:
+ llm = {item["value"]: item for item in settings_router._provider_choices()["llm"]}
+
+ assert llm["requesty"]["label"] == "Requesty"
+ assert llm["requesty"]["base_url"] == "https://router.requesty.ai/v1"
+
+
+def test_llm_provider_choices_include_futureinfra() -> None:
+ llm = {item["value"]: item for item in settings_router._provider_choices()["llm"]}
+
+ assert llm["futureinfra"]["label"] == "FutureInfra"
+ assert llm["futureinfra"]["base_url"] == "https://futureinfra.ai/v1/ai"
+
+
def test_llm_provider_choices_include_novita() -> None:
llm = {item["value"]: item for item in settings_router._provider_choices()["llm"]}
diff --cc tests/core/test_agentic_client_provider_kwargs.py
index 881a270e3,608903cf1..dc2284ad1
--- a/tests/core/test_agentic_client_provider_kwargs.py
+++ b/tests/core/test_agentic_client_provider_kwargs.py
@@@ -558,7 -558,8 +558,9 @@@ def test_registered_cloud_openai_compat
"atlascloud",
"unifically",
"cheaperinference",
+ "api_route",
+ "requesty",
+ "futureinfra",
"edenai",
"novita",
"volcengine_coding_plan",
diff --cc tests/services/config/test_provider_runtime.py
index c83906df8,eaa6160e7..3cba592f9
--- a/tests/services/config/test_provider_runtime.py
+++ b/tests/services/config/test_provider_runtime.py
@@@ -346,57 -346,102 +346,153 @@@ def test_llm_cheaperinference_base_url_
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_requesty_binding_uses_default_openai_compatible_endpoint() -> None:
+ catalog = _build_catalog(
+ llm_profile={
+ "id": "llm-p",
+ "name": "Requesty",
+ "binding": "requesty",
+ "base_url": "",
+ "api_key": "requesty-key",
+ "api_version": "",
+ "extra_headers": {},
+ "models": [
+ {
+ "id": "llm-m",
+ "name": "GPT-4o mini",
+ "model": "openai/gpt-4o-mini",
+ }
+ ],
+ }
+ )
+
+ resolved = resolve_llm_runtime_config(catalog=catalog)
+
+ assert resolved.provider_name == "requesty"
+ assert resolved.provider_mode == "gateway"
+ assert resolved.binding == "requesty"
+ assert resolved.model == "openai/gpt-4o-mini"
+ assert resolved.api_key == "requesty-key"
+ assert resolved.effective_url == "https://router.requesty.ai/v1"
+
+
+ def test_llm_requesty_base_url_detection_preserves_openai_binding_compatibility() -> None:
+ catalog = _build_catalog(
+ llm_profile={
+ "id": "llm-p",
+ "name": "OpenAI Compatible",
+ "binding": "openai",
+ "base_url": "https://router.eu.requesty.ai/v1",
+ "api_key": "requesty-key",
+ "api_version": "",
+ "extra_headers": {},
+ "models": [{"id": "llm-m", "name": "GPT", "model": "openai/gpt-5-mini"}],
+ }
+ )
+
+ resolved = resolve_llm_runtime_config(catalog=catalog)
+
+ assert resolved.provider_name == "requesty"
+ assert resolved.provider_mode == "gateway"
+ assert resolved.effective_url == "https://router.eu.requesty.ai/v1"
+
+
+def test_llm_futureinfra_binding_uses_default_openai_compatible_endpoint() -> None:
+ catalog = _build_catalog(
+ llm_profile={
+ "id": "llm-p",
+ "name": "FutureInfra",
+ "binding": "futureinfra",
+ "base_url": "",
+ "api_key": "futureinfra-key",
+ "api_version": "",
+ "extra_headers": {},
+ "models": [
+ {
+ "id": "llm-m",
+ "name": "GPT-4o mini",
+ "model": "openai/gpt-4o-mini",
+ }
+ ],
+ }
+ )
+
+ resolved = resolve_llm_runtime_config(catalog=catalog)
+
+ assert resolved.provider_name == "futureinfra"
+ assert resolved.provider_mode == "gateway"
+ assert resolved.binding == "futureinfra"
+ assert resolved.model == "openai/gpt-4o-mini"
+ assert resolved.api_key == "futureinfra-key"
+ assert resolved.effective_url == "https://futureinfra.ai/v1/ai"
+
+
+def test_llm_futureinfra_base_url_detection_preserves_openai_binding_compatibility() -> None:
+ catalog = _build_catalog(
+ llm_profile={
+ "id": "llm-p",
+ "name": "OpenAI Compatible",
+ "binding": "openai",
+ "base_url": "https://futureinfra.ai/v1/ai",
+ "api_key": "futureinfra-key",
+ "api_version": "",
+ "extra_headers": {},
+ "models": [{"id": "llm-m", "name": "GPT", "model": "openai/gpt-4o-mini"}],
+ }
+ )
+
+ resolved = resolve_llm_runtime_config(catalog=catalog)
+
+ assert resolved.provider_name == "futureinfra"
+ assert resolved.provider_mode == "gateway"
+ assert resolved.effective_url == "https://futureinfra.ai/v1/ai"
+
+
def test_llm_novita_binding_uses_default_openai_compatible_endpoint() -> None:
catalog = _build_catalog(
llm_profile={
diff --cc tests/services/test_provider_registry.py
index dc289ba13,74109be6b..bd7b95de2
--- a/tests/services/test_provider_registry.py
+++ b/tests/services/test_provider_registry.py
@@@ -79,21 -79,33 +79,48 @@@ def test_cheaperinference_provider_alia
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_requesty_provider_lookup_and_base_detection() -> None:
+ spec = find_by_name("requesty")
+
+ assert spec is not None
+ assert spec.display_name == "Requesty"
+ assert spec.env_key == "REQUESTY_API_KEY"
+ assert spec.backend == "openai_compat"
+ assert spec.mode == "gateway"
+ assert spec.default_api_base == "https://router.requesty.ai/v1"
+ assert find_gateway(api_base="https://router.requesty.ai/v1") == spec
+ assert find_gateway(api_base="https://router.eu.requesty.ai/v1") == spec
+
+
+def test_futureinfra_provider_aliases_and_base_detection() -> None:
+ spec = find_by_name("futureinfra")
+
+ assert spec is not None
+ assert spec.display_name == "FutureInfra"
+ assert spec.env_key == "FUTUREINFRA_API_KEY"
+ assert spec.backend == "openai_compat"
+ assert spec.mode == "gateway"
+ assert spec.default_api_base == "https://futureinfra.ai/v1/ai"
+ assert find_by_name("FutureInfra") == spec
+ assert find_by_name("future-infra") == spec
+ assert find_by_name("future_infra") == spec
+ assert find_gateway(api_base="https://futureinfra.ai/v1/ai") == spec
+
+
def test_openai_codex_is_not_detected_from_api_base() -> None:
assert find_gateway(api_base="https://codex.example.com/v1") is None