English Français العربية

NovAI - Chinese AI Models Gateway

Official registry AI and agents

Chinese frontier AI models as MCP tools via one OpenAI-compatible endpoint, zero platform fee.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package aiapi-pro
Claude Code 
claude mcp add novai-chinese-ai-models-gateway -e 'NOVAI_API_KEY=<NOVAI_API_KEY>' -- uvx aiapi-pro==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "novai-chinese-ai-models-gateway": {
            "command": "uvx",
            "args": [
                "aiapi-pro==0.1.1"
            ],
            "env": {
                "NOVAI_API_KEY": "<NOVAI_API_KEY>"
            }
        }
    }
}

Environment variables

  • NOVAI_API_KEY required NovAI API key. Get $2 free credit (no card) at https://aiapi-pro.com/register

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. novai-python
  2. Install
  3. SDK quickstart
  4. MCP server
  5. Transparency
  6. License

novai-python

OpenAI-compatible SDK + MCP server for 120+ Chinese frontier AI models (DeepSeek, Qwen, GLM, Kimi, Seedance, MiniMax, Hunyuan, CogVideoX, ...) via NovAI — one key, one endpoint, 0% platform fee (raw provider list price; vs OpenRouter ~5.5% markup).

  • Endpoint: https://aiapi-pro.com/v1 (change one base_url line from any OpenAI code)
  • Free: $2 signup credit, no card; plus 5 free models (no credit charge; 10 calls/day on the free tier) (glm-4.7-flash, glm-4.6v-flash, glm-4.1v-thinking-flash, cogview-3-flash, cogvideox-flash)
  • Live pricing: https://aiapi-pro.com/china-ai-leaderboard.json

Install

PyPI package name: aiapi-pro (import name: novai). Once published:

pip install aiapi-pro
export NOVAI_API_KEY=nvai-...   # https://aiapi-pro.com/register ($2 free)

From source (always current):

pip install git+https://github.com/vvvvking/novai-python.git
export NOVAI_API_KEY=nvai-...   # https://aiapi-pro.com/register ($2 free)

SDK quickstart

from novai import chat, list_models, generate_image, pricing

print(chat("deepseek-v4-flash", "Explain MCP in one sentence."))
print(generate_image("cogview-3-flash", "a red panda astronaut"))  # free model
print(pricing()["categories"][0]["models"][0])  # cheapest chat model, live

Any existing OpenAI code works by swapping the base URL:

from openai import OpenAI
c = OpenAI(base_url="https://aiapi-pro.com/v1", api_key="nvai-...")

MCP server

Expose the models as tools to any MCP client (Claude Desktop, Cursor, Cline, ...):

{
  "mcpServers": {
    "novai": {
      "command": "python",
      "args": ["-m", "novai.mcp_server"],
      "env": { "NOVAI_API_KEY": "nvai-..." }
    }
  }
}

Tools provided: novai_list_models, novai_chat, novai_generate_image, novai_free_models, novai_cheapest, novai_pricing_feed, novai_transparency.

Transparency

0% platform fee, 1.0x price multiplier, $5 min top-up, 60 req/min, unused-balance 7-day refund, failed video/3D jobs refunded in full. Machine-readable: https://aiapi-pro.com/transparency.json. Chinese image models apply a visible "AI-generated" corner watermark per China labeling rules (https://aiapi-pro.com/watermark-notice).

License

MIT

Frequently asked questions

What is NovAI - Chinese AI Models Gateway?

Chinese frontier AI models as MCP tools via one OpenAI-compatible endpoint, zero platform fee.

How do I install NovAI - Chinese AI Models Gateway?

It runs on your machine. In Claude Code: claude mcp add novai-chinese-ai-models-gateway -e 'NOVAI_API_KEY=<NOVAI_API_KEY>' -- uvx aiapi-pro==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does NovAI - Chinese AI Models Gateway need an API key?

Yes. It expects NOVAI_API_KEY, which you set in its configuration.

Is NovAI - Chinese AI Models Gateway open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains NovAI - Chinese AI Models Gateway?

It is published by vvvvking. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.