Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python

Add Novita AI provider (#1380)

jax-novitac216e9a02e87
diff --git a/.env.example b/.env.example
index 8fddc53d..9aa7a248 100644
--- a/.env.example
+++ b/.env.example
@@ -82,6 +82,10 @@ NARAROUTE_BASE_URL="https://router.bynara.id/v1"
FIREWORKS_API_KEY=""
+# Novita AI (OpenAI-compatible Chat Completions at api.novita.ai/openai/v1)
+NOVITA_API_KEY=""
+
+
# Cloudflare Workers AI Config (OpenAI-compatible Chat Completions at api.cloudflare.com/client/v4/accounts/<id>/ai/v1)
CLOUDFLARE_API_TOKEN=""
CLOUDFLARE_ACCOUNT_ID=""
@@ -131,7 +135,7 @@ OLLAMA_BASE_URL="http://localhost:11434"
# All Claude model requests are mapped to these models, plain model is fallback
# Format: provider_type/model/name
-# Valid providers: "nvidia_nim" | "openai" | "azure_openai" | "open_router" | "gemini" | "vertex" | "deepseek" | "mistral" | "mistral_codestral" | "opencode_zen" | "opencode_go" | "vercel" | "bedrock" | "huggingface" | "cohere" | "github_models" | "wafer" | "kimi" | "kimi_code" | "minimax" | "cerebras" | "groq" | "sambanova" | "kilo" | "fireworks" | "cloudflare" | "zai" | "ollama_cloud" | "lmstudio" | "llamacpp" | "ollama" | "tokenrouter" | "nararoute"
+# Valid providers: "nvidia_nim" | "openai" | "azure_openai" | "open_router" | "gemini" | "vertex" | "deepseek" | "mistral" | "mistral_codestral" | "opencode_zen" | "opencode_go" | "vercel" | "bedrock" | "huggingface" | "cohere" | "github_models" | "wafer" | "kimi" | "kimi_code" | "minimax" | "cerebras" | "groq" | "sambanova" | "kilo" | "fireworks" | "novita" | "cloudflare" | "zai" | "ollama_cloud" | "lmstudio" | "llamacpp" | "ollama" | "tokenrouter" | "nararoute"
MODEL_FABLE=
MODEL_OPUS=
MODEL_SONNET=
@@ -168,6 +172,7 @@ FCC_SMOKE_MODEL_ZAI=
FCC_SMOKE_MODEL_TOKENROUTER=
FCC_SMOKE_MODEL_NARAROUTE=
FCC_SMOKE_MODEL_FIREWORKS=
+FCC_SMOKE_MODEL_NOVITA=
FCC_SMOKE_MODEL_CLOUDFLARE=
FCC_SMOKE_MODEL_GEMINI=
FCC_SMOKE_MODEL_VERTEX=
@@ -217,6 +222,7 @@ ZAI_PROXY=""
TOKENROUTER_PROXY=""
NARAROUTE_PROXY=""
FIREWORKS_PROXY=""
+NOVITA_PROXY=""
CLOUDFLARE_PROXY=""
GEMINI_PROXY=""
VERTEX_PROXY=""
diff --git a/README.md b/README.md
index 9ea32dbd..e06a24ff 100644
--- a/README.md
+++ b/README.md
@@ -177,6 +177,7 @@ fcc-codex exec "hello"
| [SambaNova](https://cloud.sambanova.ai/apis) | `SAMBANOVA_API_KEY` | `sambanova/Meta-Llama-3.3-70B-Instruct` |
| [Kilo.ai](https://kilo.ai) | `KILO_API_KEY` | `kilo/kilo-auto/free` |
| [Fireworks AI](https://fireworks.ai/account/api-keys) | `FIREWORKS_API_KEY` | `fireworks/accounts/fireworks/models/llama-v3p3-70b-instruct` |
+| [Novita AI](https://novita.ai/settings/key-management) | `NOVITA_API_KEY` | `novita/deepseek/deepseek-v4-flash-0731` |
| [Cloudflare Workers AI](https://developers.cloudflare.com/workers-ai/) | `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID` | `cloudflare/@cf/moonshotai/kimi-k2.6` |
| [Z.ai](https://z.ai/manage-apikey/apikey-list) | `ZAI_API_KEY` | `zai/glm-5.2` |
| [TokenRouter](https://www.tokenrouter.com/) | `TOKENROUTER_API_KEY` | `tokenrouter/moonshotai/kimi-k3-free` |
diff --git a/pyproject.toml b/pyproject.toml
index 8cb185a0..f70706db 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "free-claude-code"
-version = "4.19.0"
+version = "4.20.0"
description = "Local proxy connecting coding agents to OpenAI-compatible AI providers"
readme = "README.md"
requires-python = ">=3.14.0"
diff --git a/smoke/lib/config.py b/smoke/lib/config.py
index f9c8f3f0..6a95d8c0 100644
--- a/smoke/lib/config.py
+++ b/smoke/lib/config.py
@@ -73,6 +73,7 @@ PROVIDER_SMOKE_DEFAULT_MODELS: dict[str, str] = {
"sambanova": "sambanova/Meta-Llama-3.3-70B-Instruct",
"kilo": "kilo/kilo-auto/free",
"cerebras": "cerebras/llama3.1-8b",
+ "novita": "novita/deepseek/deepseek-v4-flash-0731",
"cloudflare": "cloudflare/@cf/moonshotai/kimi-k2.6",
"tokenrouter": "tokenrouter/moonshotai/kimi-k3-free",
"nararoute": "nararoute/kimi-k3-free",
diff --git a/src/free_claude_code/config/admin/provider_manifest.py b/src/free_claude_code/config/admin/provider_manifest.py
index f279c3ac..395f752d 100644
--- a/src/free_claude_code/config/admin/provider_manifest.py
+++ b/src/free_claude_code/config/admin/provider_manifest.py
@@ -92,6 +92,13 @@ _PROVIDER_FIELD_OVERRIDES: dict[str, dict[str, Any]] = {
"label": "Fireworks API Key",
"description": "Fireworks AI inference API key.",
},
+ "NOVITA_API_KEY": {
+ "label": "Novita AI API Key",
+ "description": (
+ "Novita AI OpenAI-compatible API key (create at "
+ "[novita.ai/settings/key-management](https://novita.ai/settings/key-management))."
+ ),
+ },
"MINIMAX_API_KEY": {
"label": "MiniMax API Key",
"description": (
diff --git a/src/free_claude_code/config/provider_catalog.py b/src/free_claude_code/config/provider_catalog.py
index 171fb767..7e47daab 100644
--- a/src/free_claude_code/config/provider_catalog.py
+++ b/src/free_claude_code/config/provider_catalog.py
@@ -18,6 +18,7 @@ MINIMAX_DEFAULT_BASE = "https://api.minimax.io/v1"
# DeepSeek Chat Completions API; cache usage is reported on this endpoint.
DEEPSEEK_DEFAULT_BASE = "https://api.deepseek.com"
FIREWORKS_DEFAULT_BASE = "https://api.fireworks.ai/inference/v1"
+NOVITA_DEFAULT_BASE = "https://api.novita.ai/openai/v1"
# Cloudflare account-scoped AI REST root; provider appends /accounts/{id}/ai/v1.
CLOUDFLARE_AI_REST_ROOT = "https://api.cloudflare.com/client/v4"
OPENROUTER_DEFAULT_BASE = "https://openrouter.ai/api/v1"
@@ -320,6 +321,15 @@ PROVIDER_CATALOG: dict[str, ProviderDescriptor] = {
default_base_url=FIREWORKS_DEFAULT_BASE,
proxy_attr="fireworks_proxy",
),
+ "novita": ProviderDescriptor(
+ provider_id="novita",
+ display_name="Novita AI",
+ credential_env="NOVITA_API_KEY",
+ credential_url="https://novita.ai/settings/key-management",
+ credential_attr="novita_api_key",
+ default_base_url=NOVITA_DEFAULT_BASE,
+ proxy_attr="novita_proxy",
+ ),
"cloudflare": ProviderDescriptor(
provider_id="cloudflare",
display_name="Cloudflare",
diff --git a/src/free_claude_code/config/settings.py b/src/free_claude_code/config/settings.py
index ba3ad5ac..c68b4ade 100644
--- a/src/free_claude_code/config/settings.py
+++ b/src/free_claude_code/config/settings.py
@@ -110,6 +110,9 @@ class Settings(BaseSettings):
# ==================== Fireworks AI Config ====================
fireworks_api_key: str = Field(default="", validation_alias="FIREWORKS_API_KEY")
+ # ==================== Novita AI Config ====================
+ novita_api_key: str = Field(default="", validation_alias="NOVITA_API_KEY")
+
# ==================== Cloudflare Workers AI Config ====================
cloudflare_api_token: str = Field(
default="", validation_alias="CLOUDFLARE_API_TOKEN"
@@ -207,6 +210,7 @@ class Settings(BaseSettings):
tokenrouter_proxy: str = Field(default="", validation_alias="TOKENROUTER_PROXY")
nararoute_proxy: str = Field(default="", validation_alias="NARAROUTE_PROXY")
fireworks_proxy: str = Field(default="", validation_alias="FIREWORKS_PROXY")
+ novita_proxy: str = Field(default="", validation_alias="NOVITA_PROXY")
cloudflare_proxy: str = Field(default="", validation_alias="CLOUDFLARE_PROXY")
gemini_proxy: str = Field(default="", validation_alias="GEMINI_PROXY")
vertex_proxy: str = Field(default="", validation_alias="VERTEX_PROXY")
diff --git a/src/free_claude_code/providers/openai_chat/profiles.py b/src/free_claude_code/providers/openai_chat/profiles.py
index 4ad04b55..87c8e5b2 100644
--- a/src/free_claude_code/providers/openai_chat/profiles.py
+++ b/src/free_claude_code/providers/openai_chat/profiles.py
@@ -315,6 +315,22 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {
budget_field="reasoning_effort",
),
),
+ "novita": OpenAIChatProfile(
+ _policy(
+ "NOVITA",
+ ReasoningReplayMode.REASONING_CONTENT,
+ include_extra_body=True,
+ extra_body_validator=validate_extra_body_does_not_override_reasoning_fields,
+ default_max_tokens=ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS,
+ ),
+ NamedEffortReasoning(
+ (),
+ disabled_value=False,
+ enabled_value=True,
+ field="enable_thinking",
+ use_extra_body=True,
+ ),
+ ),
"zai": OpenAIChatProfile(
_policy(
"ZAI",
diff --git a/tests/contracts/test_provider_catalog_order.py b/tests/contracts/test_provider_catalog_order.py
index 2e845e87..4ce18242 100644
--- a/tests/contracts/test_provider_catalog_order.py
+++ b/tests/contracts/test_provider_catalog_order.py
@@ -31,6 +31,7 @@ _EXPECTED_PROVIDER_ORDER: tuple[str, ...] = (
"cerebras",
"sambanova",
"fireworks",
+ "novita",
"cloudflare",
"zai",
"tokenrouter",
diff --git a/tests/contracts/test_smoke_config.py b/tests/contracts/test_smoke_config.py
index e8c9b4f4..29d529f1 100644
--- a/tests/contracts/test_smoke_config.py
+++ b/tests/contracts/test_smoke_config.py
@@ -57,6 +57,7 @@ def _settings(**overrides):
"cerebras_api_key": "",
"ollama_api_key": "",
"fireworks_api_key": "",
+ "novita_api_key": "",
"cloudflare_api_token": "",
"cloudflare_account_id": "",
"lm_studio_base_url": "",
diff --git a/tests/providers/test_novita.py b/tests/providers/test_novita.py
new file mode 100644
index 00000000..5de6fcbc
--- /dev/null
+++ b/tests/providers/test_novita.py
@@ -0,0 +1,153 @@
+"""Tests for the Novita AI OpenAI-chat provider."""
+
+from unittest.mock import AsyncMock, MagicMock
+
+import pytest
+
+from free_claude_code.application.errors import InvalidRequestError
+from free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS
+from free_claude_code.config.provider_catalog import NOVITA_DEFAULT_BASE
+from free_claude_code.core.anthropic.models import Message, MessagesRequest
+from free_claude_code.core.reasoning import ReasoningPolicy
+from free_claude_code.providers.base import ProviderConfig
+from free_claude_code.providers.openai_chat import OpenAIChatProvider
+from tests.providers.support import (
+ REASONING_OFF,
+ REASONING_ON,
+ immediate_admission,
+ profiled_provider,
+ reasoning_for,
+)
+
+
+def novita_provider():
+ return profiled_provider(
+ "novita",
+ ProviderConfig(
+ api_key="test_novita_key",
+ base_url=NOVITA_DEFAULT_BASE,
+ rate_limit=10,
+ rate_window=60,
+ ),
+ admission=immediate_admission(),
+ )
+
+
+def test_init_uses_openai_chat_provider(novita_provider):
+ assert isinstance(novita_provider, OpenAIChatProvider)
+ assert novita_provider._api_key == "test_novita_key"
+ assert novita_provider._base_url == NOVITA_DEFAULT_BASE
+
+
+def test_base_url_constant():
+ assert NOVITA_DEFAULT_BASE == "https://api.novita.ai/openai/v1"
+
+
+def test_build_request_body_openai_chat_shape(novita_provider):
+ request = MessagesRequest(
+ model="deepseek/deepseek-v4-flash-0731",
+ max_tokens=100,
+ messages=[Message(role="user", content="Hello")],
+ system="System prompt",
+ )
+
+ body = novita_provider._build_request_body(
+ request, reasoning=reasoning_for(request)
+ )
+
+ assert body["model"] == "deepseek/deepseek-v4-flash-0731"
+ assert body["max_tokens"] == 100
+ assert body["messages"] == [
+ {"role": "system", "content": "System prompt"},
+ {"role": "user", "content": "Hello"},
+ ]
+
+
+def test_build_request_body_default_max_tokens(novita_provider):
+ request = MessagesRequest(
+ model="m",
+ messages=[Message(role="user", content="x")],
+ )
+
+ body = novita_provider._build_request_body(
+ request, reasoning=reasoning_for(request)
+ )
+
+ assert body["max_tokens"] == ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS
+
+
+def test_build_request_body_preserves_validated_extra_body(novita_provider):
+ request = MessagesRequest.model_validate(
+ {
+ "model": "m",
+ "messages": [{"role": "user", "content": "x"}],
+ "extra_body": {"custom_param": "value"},
+ }
+ )
+
+ body = novita_provider._build_request_body(
+ request, reasoning=reasoning_for(request)
+ )
+
+ assert body["extra_body"]["custom_param"] == "value"
+
+
+def test_build_request_body_rejects_reserved_reasoning_extra_body_keys(
+ novita_provider,
+):
+ request = MessagesRequest.model_validate(
+ {
+ "model": "m",
+ "messages": [{"role": "user", "content": "x"}],
+ "extra_body": {"reasoning_effort": "high"},
+ }
+ )
+
+ with pytest.raises(InvalidRequestError, match="extra_body must not override"):
+ novita_provider._build_request_body(request, reasoning=reasoning_for(request))
+
+
+def test_build_request_body_disables_thinking_when_reasoning_off(novita_provider):
+ request = MessagesRequest(
+ model="zai-org/glm-5.2",
+ messages=[Message(role="user", content="x")],
+ )
+
+ body = novita_provider._build_request_body(request, reasoning=REASONING_OFF)
+
+ assert body["extra_body"]["enable_thinking"] is False
+
+
+def test_build_request_body_enables_thinking_when_reasoning_on(novita_provider):
+ request = MessagesRequest(
+ model="zai-org/glm-5.2",
+ messages=[Message(role="user", content="x")],
+ )
+
+ body = novita_provider._build_request_body(request, reasoning=REASONING_ON)
+
+ assert body["extra_body"]["enable_thinking"] is True
+
+
+def test_build_request_body_omits_thinking_field_by_default(novita_provider):
+ request = MessagesRequest(
+ model="zai-org/glm-5.2",
+ messages=[Message(role="user", content="x")],
+ )
+
+ body = novita_provider._build_request_body(
+ request, reasoning=ReasoningPolicy.provider_default()
+ )
+
+ assert "enable_thinking" not in body.get("extra_body", {})
+
+
+async def test_cleanup_closes_openai_client(novita_provider):
+ novita_provider._client = MagicMock()
+ novita_provider._client.close = AsyncMock()
+
+ await novita_provider.cleanup()
+
+ novita_provider._client.close.assert_awaited_once()
diff --git a/tests/providers/test_provider_runtime.py b/tests/providers/test_provider_runtime.py
index 395b9050..2b5013a8 100644
--- a/tests/providers/test_provider_runtime.py
+++ b/tests/providers/test_provider_runtime.py
@@ -105,6 +105,8 @@ def _make_settings(**overrides):
mock.nararoute_proxy = ""
mock.fireworks_proxy = ""
mock.fireworks_api_key = "test_fireworks_key"
+ mock.novita_proxy = ""
+ mock.novita_api_key = "test_novita_key"
mock.cloudflare_api_token = "test_cloudflare_token"
mock.cloudflare_account_id = "test_cloudflare_account"
mock.cloudflare_proxy = ""
@@ -463,6 +465,7 @@ def test_create_provider_instantiates_each_builtin():
groq_api_key="test_groq_key",
cerebras_api_key="test_cerebras_key",
fireworks_api_key="test_fireworks_key",
+ novita_api_key="test_novita_key",
cloudflare_api_token="test_cloudflare_token",
cloudflare_account_id="test_cloudflare_account",
vercel_ai_gateway_api_key="test_vercel_key",
@@ -489,6 +492,7 @@ def test_create_provider_instantiates_each_builtin():
"kimi_code": OpenAIChatProvider,
"minimax": OpenAIChatProvider,
"fireworks": OpenAIChatProvider,
+ "novita": OpenAIChatProvider,
"cloudflare": CloudflareProvider,
"lmstudio": LMStudioProvider,
"llamacpp": OpenAIChatProvider,
diff --git a/uv.lock b/uv.lock
index 22f172ea..00b4857c 100644
--- a/uv.lock
+++ b/uv.lock
@@ -620,7 +620,7 @@ wheels = [
[[package]]
name = "free-claude-code"
-version = "4.19.0"
+version = "4.20.0"
source = { editable = "." }
dependencies = [
{ name = "aiohttp" },