NovAI - Chinese AI Models Gateway

io.github.vvvvkingv0.1.1Updated Oct 10, 2026

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

VerifiedSTDIODesktop onlyAI & MLMedia & Design

Overview

AI-generated overview

Lets an assistant call 120+ Chinese frontier AI models for chat and image generation through one OpenAI-compatible endpoint.

What it does
A local MCP server that exposes NovAI's OpenAI-compatible model gateway as tools. Tools include novai_list_models, novai_chat, novai_generate_image, novai_free_models, novai_cheapest, novai_pricing_feed and novai_transparency. It covers models such as DeepSeek, Qwen, GLM, Kimi, MiniMax and Hunyuan, and also ships a Python SDK with the same base URL.
When to use it
Use it when an assistant should reach Chinese frontier models for chat or image generation without integrating each provider separately, or when you want to compare live model pricing from inside a client.
Requirements
Python with the aiapi-pro PyPI package (import name novai), run as a local stdio process. Requires the NOVAI_API_KEY environment variable; a free signup credit is offered. Network access to the provider endpoint is needed.
Before you install
NOVAI_API_KEY is a billable credential sent to a third-party gateway; usage beyond free credit costs money, with a stated minimum top-up. Image generation may add a visible AI-generated watermark. Prompts and generated content go to the provider.

Installation

In SourceWeft

  1. Open NovAI - Chinese AI Models Gateway in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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 free-unlimited models (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:

bash
pip install aiapi-proexport NOVAI_API_KEY=sk-...   # https://aiapi-pro.com/register ($2 free)

From source (always current):

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

SDK quickstart

python
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 modelprint(pricing()["categories"][0]["models"][0])  # cheapest chat model, live

Any existing OpenAI code works by swapping the base URL:

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

MCP server

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

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

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

Source: README.md at commit 84d4caf

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.1.1LatestOct 10, 2026