# NovAI - Chinese AI Models Gateway

> NovAI - Chinese AI Models Gateway is a freemium MCP server for ai models and llm tooling. One OpenAI-compatible endpoint for 100+ Chinese AI models, exposed as MCP tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://aiapi-pro.com
- **Repository:** https://github.com/vvvvking/novai-python
- **MCP Registry name:** io.github.vvvvking/novai-python
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

NovAI is a gateway to models from Chinese labs, and this package is both a small Python SDK and an MCP server for it. Models come from DeepSeek, Qwen, GLM, Kimi, MiniMax, Hunyuan, Doubao and Seedance, among others, covering chat, image, video, embeddings and more. Any code written for the OpenAI client works by changing the base URL to `https://aiapi-pro.com/v1`.

The site and README state a 0% platform fee at provider list price, and its model page sets prices next to OpenRouter's. These are the vendor's own comparisons, not independent benchmarks. Five models are marked free, with 10 calls a day on the free tier: `glm-4.7-flash`, `glm-4.6v-flash`, `glm-4.1v-thinking-flash`, `cogview-3-flash` and `cogvideox-flash`.

The terms listed include a $5 minimum top-up, 60 requests a minute, a 7-day refund on unused balance and full refunds for failed video or 3D jobs. Chinese image models add a visible AI-generated watermark. Install with `pip install aiapi-pro` and set `NOVAI_API_KEY`.

## Features

- **OpenAI-compatible API:** Swap one base URL line in existing OpenAI code.
- **Many model families:** Chat, vision, image, video and OCR models from several labs.
- **Free models:** Five models can be used without credit charge, within daily limits.
- **Live pricing feed:** Tools return current prices and the cheapest chat model.
- **Transparent terms:** Published fee, rate limit and refund terms in a machine-readable file.
- **MCP and SDK:** Same models as MCP tools or Python functions.

## Good for

- Try Chinese models from Claude Desktop or Cursor
- Find the cheapest model for a task from inside a chat
- Generate images with a free model
- Compare gateway prices against OpenRouter
- Switch an existing OpenAI-based app to other models

## Install

### Claude Code (Terminal)

```sh
claude mcp add novai-python --env NOVAI_API_KEY='<NOVAI_API_KEY>' -- uvx aiapi-pro
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "novai-python": {
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "novai-python": {
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "novai-python": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "novai-python": {
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "novai-python": {
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}
```

## Tools

- `novai_list_models`: Lists the available models.
- `novai_chat`: Sends a chat request to a chosen model.
- `novai_generate_image`: Generates an image with a chosen model.
- `novai_free_models`: Lists the models that are free to use.
- `novai_cheapest`: Finds the cheapest model.
- `novai_pricing_feed`: Returns the live pricing feed.
- `novai_transparency`: Returns the gateway's published terms.

## FAQ

### How do I get started?

Register for $2 of free credit with no card, install `aiapi-pro` and set `NOVAI_API_KEY`.

### What does the MCP server expose?

Seven tools including `novai_chat`, `novai_generate_image` and `novai_pricing_feed`.

### What are the limits?

60 requests a minute, a $5 minimum top-up, and 10 calls a day on the free models.

### Is the SDK open source?

The README lists an MIT license.

### What if a video job fails?

Failed video and 3D jobs are refunded in full.

### Is NovAI - Chinese AI Models Gateway free?

NovAI - Chinese AI Models Gateway has a free plan, with paid plans for more usage or features.

### How do I add NovAI - Chinese AI Models Gateway to Claude Code?

Run this command in your terminal: claude mcp add novai-python --env NOVAI_API_KEY='<NOVAI_API_KEY>' -- uvx aiapi-pro

### What are the best alternatives to NovAI - Chinese AI Models Gateway?

The closest alternatives to NovAI - Chinese AI Models Gateway are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

## Alternatives

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.
- [Agent Data Tools: Compact (find, describe, run)](https://ai-powered.com/mcp/agent-data-tools-compact-find-describe-run): Agent Data Tools: Compact (find, describe, run) is a freemium MCP server for developer tools.
- [Angel Agent Guard: pre-purchase check + prompt-injection scan](https://ai-powered.com/mcp/angel-agent-guard-pre-purchase-check-prompt-injection-scan): Angel Agent Guard: pre-purchase check + prompt-injection scan is a freemium MCP server for ai models and llm tooling.
- [Mizan Calibration](https://ai-powered.com/mcp/mizan-calibration): Mizan Calibration is a free MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/novai-chinese-ai-models-gateway
