From 0d8653d3e82f990fa7dac01a420d1a0686e41ce1 Mon Sep 17 00:00:00 2001 From: superbot <5358899+ux-xd@users.noreply.github.com> Date: Tue, 20 Oct 2026 00:12:20 -0600 Subject: [PATCH] feat(providers): add superbot as an OpenAI-compatible provider Registers superbot as a JSON-configured OpenAI-compatible provider (SUPERBOT_API_KEY, SUPERBOT_API_BASE), adds it to the Admin UI Add Model form and the endpoint support matrix, prices superbot/superbot and superbot/superbot-fast at the list prices on https://superbot.gg/pricing, and adds a mocked unit test. --- litellm/constants.py | 2 + litellm/llms/openai_like/providers.json | 5 + ...odel_prices_and_context_window_backup.json | 28 +++ .../provider_endpoints_support_backup.json | 18 ++ .../provider_create_fields.json | 28 +++ litellm/types/utils.py | 1 + model_prices_and_context_window.json | 28 +++ provider_endpoints_support.json | 18 ++ .../openai_like/test_superbot_provider.py | 224 ++++++++++++++++++ 9 files changed, 352 insertions(+) create mode 100644 tests/unit/llms/openai_like/test_superbot_provider.py diff --git a/litellm/constants.py b/litellm/constants.py index c7673db6976..b569b92c8fb 100644 --- a/litellm/constants.py +++ b/litellm/constants.py @@ -1051,6 +1051,7 @@ openai_compatible_endpoints: Final[list[str]] = [ "https://api.reka.ai/v1", "https://gigachat.devices.sberbank.ru/api/v1", "https://api.openinfer.ai/v1", + "https://api.superbot.gg/v1", ] @@ -1129,6 +1130,7 @@ openai_compatible_providers: Final[list[str]] = [ "prism", "sail", "reka", + "superbot", ] OPENAI_AUDIO_TRANSCRIPTION_PROVIDERS: Final = frozenset({"openai"} | frozenset(openai_compatible_providers)) diff --git a/litellm/llms/openai_like/providers.json b/litellm/llms/openai_like/providers.json index 36337fddbdc..12f737f75fc 100644 --- a/litellm/llms/openai_like/providers.json +++ b/litellm/llms/openai_like/providers.json @@ -249,5 +249,10 @@ "/v1/responses", "/v1/messages" ] + }, + "superbot": { + "base_url": "https://api.superbot.gg/v1", + "api_key_env": "SUPERBOT_API_KEY", + "api_base_env": "SUPERBOT_API_BASE" } } diff --git a/litellm/model_prices_and_context_window_backup.json b/litellm/model_prices_and_context_window_backup.json index cc284c0ce4c..bfa47f0fb3b 100644 --- a/litellm/model_prices_and_context_window_backup.json +++ b/litellm/model_prices_and_context_window_backup.json @@ -76119,6 +76119,34 @@ "supports_reasoning": true, "source": "https://api.openinfer.ai/v1/models" }, + "superbot/superbot": { + "max_tokens": 65536, + "max_input_tokens": 1000000, + "max_output_tokens": 65536, + "input_cost_per_token": 1e-06, + "output_cost_per_token": 5e-06, + "cache_read_input_token_cost": 5e-08, + "cache_creation_input_token_cost": 1.25e-06, + "litellm_provider": "superbot", + "mode": "chat", + "supports_function_calling": true, + "supports_reasoning": true, + "source": "https://superbot.gg/pricing" + }, + "superbot/superbot-fast": { + "max_tokens": 65536, + "max_input_tokens": 500000, + "max_output_tokens": 65536, + "input_cost_per_token": 1e-06, + "output_cost_per_token": 5e-06, + "cache_read_input_token_cost": 5e-08, + "cache_creation_input_token_cost": 1.25e-06, + "litellm_provider": "superbot", + "mode": "chat", + "supports_function_calling": true, + "supports_reasoning": true, + "source": "https://superbot.gg/pricing" + }, "xai/grok-voice-3.0": { "input_cost_per_second": 0.001333333333333, "input_cost_per_text_message": 0.004, diff --git a/litellm/provider_endpoints_support_backup.json b/litellm/provider_endpoints_support_backup.json index f95b553c2b4..7d512d65cac 100644 --- a/litellm/provider_endpoints_support_backup.json +++ b/litellm/provider_endpoints_support_backup.json @@ -2207,6 +2207,24 @@ "interactions": false } }, + "superbot": { + "display_name": "superbot (`superbot`)", + "url": "https://docs.litellm.ai/docs/providers/superbot", + "endpoints": { + "chat_completions": true, + "messages": true, + "responses": true, + "embeddings": false, + "image_generations": false, + "audio_transcriptions": false, + "audio_speech": false, + "moderations": false, + "batches": false, + "rerank": false, + "a2a": false, + "interactions": false + } + }, "snowflake": { "display_name": "Snowflake (`snowflake`)", "url": "https://docs.litellm.ai/docs/providers/snowflake", diff --git a/litellm/proxy/public_endpoints/provider_create_fields.json b/litellm/proxy/public_endpoints/provider_create_fields.json index a794854ce19..bf7610bcd03 100644 --- a/litellm/proxy/public_endpoints/provider_create_fields.json +++ b/litellm/proxy/public_endpoints/provider_create_fields.json @@ -3315,6 +3315,34 @@ ], "default_model_placeholder": "sail/openai/gpt-oss-120b" }, + { + "provider": "Superbot", + "provider_display_name": "superbot", + "litellm_provider": "superbot", + "credential_fields": [ + { + "key": "api_base", + "label": "API Base", + "placeholder": "https://api.superbot.gg/v1", + "tooltip": null, + "required": false, + "field_type": "text", + "options": null, + "default_value": null + }, + { + "key": "api_key", + "label": "API Key", + "placeholder": null, + "tooltip": null, + "required": true, + "field_type": "password", + "options": null, + "default_value": null + } + ], + "default_model_placeholder": "superbot/superbot" + }, { "provider": "Sambanova", "provider_display_name": "Sambanova", diff --git a/litellm/types/utils.py b/litellm/types/utils.py index 576c4f093d3..9fe80f3680b 100644 --- a/litellm/types/utils.py +++ b/litellm/types/utils.py @@ -4534,6 +4534,7 @@ class LlmProviders(str, Enum): META = "meta" SAIL = "sail" REKA = "reka" + SUPERBOT = "superbot" LITELLM_AGENT = "litellm_agent" CURSOR = "cursor" BEDROCK_MANTLE = "bedrock_mantle" diff --git a/model_prices_and_context_window.json b/model_prices_and_context_window.json index cc284c0ce4c..bfa47f0fb3b 100644 --- a/model_prices_and_context_window.json +++ b/model_prices_and_context_window.json @@ -76119,6 +76119,34 @@ "supports_reasoning": true, "source": "https://api.openinfer.ai/v1/models" }, + "superbot/superbot": { + "max_tokens": 65536, + "max_input_tokens": 1000000, + "max_output_tokens": 65536, + "input_cost_per_token": 1e-06, + "output_cost_per_token": 5e-06, + "cache_read_input_token_cost": 5e-08, + "cache_creation_input_token_cost": 1.25e-06, + "litellm_provider": "superbot", + "mode": "chat", + "supports_function_calling": true, + "supports_reasoning": true, + "source": "https://superbot.gg/pricing" + }, + "superbot/superbot-fast": { + "max_tokens": 65536, + "max_input_tokens": 500000, + "max_output_tokens": 65536, + "input_cost_per_token": 1e-06, + "output_cost_per_token": 5e-06, + "cache_read_input_token_cost": 5e-08, + "cache_creation_input_token_cost": 1.25e-06, + "litellm_provider": "superbot", + "mode": "chat", + "supports_function_calling": true, + "supports_reasoning": true, + "source": "https://superbot.gg/pricing" + }, "xai/grok-voice-3.0": { "input_cost_per_second": 0.001333333333333, "input_cost_per_text_message": 0.004, diff --git a/provider_endpoints_support.json b/provider_endpoints_support.json index d65da3f41fd..414f7dde8e7 100644 --- a/provider_endpoints_support.json +++ b/provider_endpoints_support.json @@ -2479,6 +2479,24 @@ "interactions": false } }, + "superbot": { + "display_name": "superbot (`superbot`)", + "url": "https://docs.litellm.ai/docs/providers/superbot", + "endpoints": { + "chat_completions": true, + "messages": true, + "responses": true, + "embeddings": false, + "image_generations": false, + "audio_transcriptions": false, + "audio_speech": false, + "moderations": false, + "batches": false, + "rerank": false, + "a2a": false, + "interactions": false + } + }, "snowflake": { "display_name": "Snowflake (`snowflake`)", "url": "https://docs.litellm.ai/docs/providers/snowflake", diff --git a/tests/unit/llms/openai_like/test_superbot_provider.py b/tests/unit/llms/openai_like/test_superbot_provider.py new file mode 100644 index 00000000000..77b23f4cbc1 --- /dev/null +++ b/tests/unit/llms/openai_like/test_superbot_provider.py @@ -0,0 +1,224 @@ +import json +from pathlib import Path +from typing import Final + +import pytest +import respx + +import litellm +from litellm.caching.llm_caching_handler import LLMClientCache + +# Stand-in credentials for the mocked upstream. They are not real keys. +EXPLICIT_CREDENTIAL: Final = "explicit-credential-for-tests" +ENV_CREDENTIAL: Final = "env-credential-for-tests" + +_CHAT_COMPLETION: Final = { + "id": "chatcmpl_superbot", + "object": "chat.completion", + "created": 1_790_000_000, + "model": "superbot", + "choices": [ + { + "index": 0, + "message": {"role": "assistant", "content": "Hello from superbot"}, + "finish_reason": "stop", + } + ], + "usage": {"prompt_tokens": 4, "completion_tokens": 3, "total_tokens": 7}, +} + + +def test_superbot_is_a_registered_provider(): + assert litellm.LlmProviders.SUPERBOT.value == "superbot" + assert "superbot" in litellm.provider_list + assert "superbot" in litellm.constants.openai_compatible_providers + + +def test_superbot_provider_resolution(monkeypatch: pytest.MonkeyPatch): + from litellm.litellm_core_utils.get_llm_provider_logic import get_llm_provider + + monkeypatch.setenv("SUPERBOT_API_KEY", ENV_CREDENTIAL) + + model, provider, resolved_key, api_base = get_llm_provider( + model="superbot/superbot-fast", + custom_llm_provider=None, + api_base=None, + api_key=None, + ) + + assert model == "superbot-fast" + assert provider == "superbot" + assert resolved_key == ENV_CREDENTIAL + assert api_base == "https://api.superbot.gg/v1" + + +def test_superbot_provider_keeps_explicit_credentials(monkeypatch: pytest.MonkeyPatch): + from litellm.litellm_core_utils.get_llm_provider_logic import get_llm_provider + + monkeypatch.setenv("SUPERBOT_API_KEY", ENV_CREDENTIAL) + monkeypatch.setenv("SUPERBOT_API_BASE", "https://superbot.env.example/v1") + + _, provider, resolved_key, api_base = get_llm_provider( + model="superbot/superbot", + custom_llm_provider=None, + api_base="https://superbot.internal.example/v1", + api_key=EXPLICIT_CREDENTIAL, + ) + + assert provider == "superbot" + assert resolved_key == EXPLICIT_CREDENTIAL + assert api_base == "https://superbot.internal.example/v1" + + +def test_superbot_api_base_env_overrides_default(monkeypatch: pytest.MonkeyPatch): + from litellm.litellm_core_utils.get_llm_provider_logic import get_llm_provider + + monkeypatch.setenv("SUPERBOT_API_KEY", ENV_CREDENTIAL) + monkeypatch.setenv("SUPERBOT_API_BASE", "https://superbot.env.example/v1") + + _, provider, _, api_base = get_llm_provider( + model="superbot/superbot", + custom_llm_provider=None, + api_base=None, + api_key=None, + ) + + assert provider == "superbot" + assert api_base == "https://superbot.env.example/v1" + + +def test_superbot_api_base_autodetects_provider(monkeypatch: pytest.MonkeyPatch): + from litellm.litellm_core_utils.get_llm_provider_logic import get_llm_provider + + monkeypatch.setenv("SUPERBOT_API_KEY", ENV_CREDENTIAL) + + model, provider, resolved_key, api_base = get_llm_provider( + model="superbot", + custom_llm_provider=None, + api_base="https://api.superbot.gg/v1", + api_key=None, + ) + + assert model == "superbot" + assert provider == "superbot" + assert resolved_key == ENV_CREDENTIAL + assert api_base == "https://api.superbot.gg/v1" + + +def test_superbot_is_available_in_add_model_form(): + fields_path = Path(litellm.__file__).parent / "proxy" / "public_endpoints" / "provider_create_fields.json" + providers = json.loads(fields_path.read_text()) + superbot = next(provider for provider in providers if provider["litellm_provider"] == "superbot") + + assert superbot["provider"] == "Superbot" + assert superbot["provider_display_name"] == "superbot" + assert superbot["default_model_placeholder"] == "superbot/superbot" + assert {field["key"]: field["required"] for field in superbot["credential_fields"]} == { + "api_base": False, + "api_key": True, + } + + +def test_superbot_supported_endpoints(): + expected: Final = { + "chat_completions": True, + "messages": True, + "responses": True, + "embeddings": False, + "image_generations": False, + "audio_transcriptions": False, + "audio_speech": False, + "moderations": False, + "batches": False, + "rerank": False, + "a2a": False, + "interactions": False, + } + backup_path = Path(litellm.__file__).parent / "provider_endpoints_support_backup.json" + root_path = Path(litellm.__file__).parent.parent / "provider_endpoints_support.json" + + assert json.loads(backup_path.read_text())["providers"]["superbot"]["endpoints"] == expected + assert json.loads(root_path.read_text())["providers"]["superbot"]["endpoints"] == expected + + +@pytest.mark.parametrize( + "model_id, context", + [("superbot/superbot", 1_000_000), ("superbot/superbot-fast", 500_000)], +) +def test_superbot_models_are_priced_in_both_cost_maps(model_id: str, context: int): + root = Path(litellm.__file__).parent.parent + maps: Final = [ + root / "model_prices_and_context_window.json", + Path(litellm.__file__).parent / "model_prices_and_context_window_backup.json", + ] + for path in maps: + row = json.loads(path.read_text())[model_id] + assert row["litellm_provider"] == "superbot" + assert row["mode"] == "chat" + assert row["max_input_tokens"] == context + assert row["max_output_tokens"] == 65_536 + assert row["input_cost_per_token"] == pytest.approx(1.0e-6) + assert row["output_cost_per_token"] == pytest.approx(5.0e-6) + assert row["cache_read_input_token_cost"] == pytest.approx(5.0e-8) + assert row["cache_creation_input_token_cost"] == pytest.approx(1.25e-6) + assert row["supports_function_calling"] is True + + +def test_superbot_chat_completion_request(): + with respx.mock() as upstream: + route: Final = upstream.post("https://api.superbot.gg/v1/chat/completions").respond(200, json=_CHAT_COMPLETION) + response: Final = litellm.completion( + model="superbot/superbot", + messages=[{"role": "user", "content": "Say hello"}], + api_key=EXPLICIT_CREDENTIAL, + ) + + request: Final = route.calls.last.request + body: Final = json.loads(request.content) + assert route.call_count == 1 + assert str(request.url) == "https://api.superbot.gg/v1/chat/completions" + assert request.headers["authorization"] == f"Bearer {EXPLICIT_CREDENTIAL}" + assert body["model"] == "superbot" + assert body["messages"] == [{"role": "user", "content": "Say hello"}] + assert response.choices[0].message.content == "Hello from superbot" + + +def test_superbot_responses_request_is_bridged_to_chat_completions(): + with respx.mock() as upstream: + route: Final = upstream.post("https://api.superbot.gg/v1/chat/completions").respond(200, json=_CHAT_COMPLETION) + response: Final = litellm.responses( + model="superbot/superbot", + input="Say hello", + api_key=EXPLICIT_CREDENTIAL, + ) + + request: Final = route.calls.last.request + body: Final = json.loads(request.content) + assert route.call_count == 1 + assert request.headers["authorization"] == f"Bearer {EXPLICIT_CREDENTIAL}" + assert body["model"] == "superbot" + assert body["messages"] == [{"role": "user", "content": "Say hello"}] + assert response.output[0].content[0].text == "Hello from superbot" + + +@pytest.mark.asyncio +async def test_superbot_anthropic_messages_request_is_bridged_to_chat_completions(monkeypatch: pytest.MonkeyPatch): + monkeypatch.setattr(litellm, "disable_aiohttp_transport", True) + monkeypatch.setattr(litellm, "in_memory_llm_clients_cache", LLMClientCache()) + with respx.mock() as upstream: + route: Final = upstream.post("https://api.superbot.gg/v1/chat/completions").respond(200, json=_CHAT_COMPLETION) + response: Final = await litellm.anthropic.messages.acreate( + model="superbot/superbot", + messages=[{"role": "user", "content": "Say hello"}], + max_tokens=32, + api_key=EXPLICIT_CREDENTIAL, + ) + + request: Final = route.calls.last.request + body: Final = json.loads(request.content) + assert route.call_count == 1 + assert request.headers["authorization"] == f"Bearer {EXPLICIT_CREDENTIAL}" + assert body["model"] == "superbot" + assert body["messages"] == [{"role": "user", "content": "Say hello"}] + assert body["max_tokens"] == 32 + assert response["content"][0]["text"] == "Hello from superbot"