mcpField
N
NovAI - Chinese AI Models Gateway

NovAI - Chinese AI Models Gateway

Local
aiapi-pro.comAI & Agents0Updated 4d ago
RepositoryVisit website

About NovAI - Chinese AI Models Gateway

NovAI provides an OpenAI-compatible Python SDK and MCP server for accessing Chinese AI models through one endpoint. It includes chat, image generation, model discovery, and pricing tools.

Key features

  1. 01Access 120+ Chinese AI models
  2. 02OpenAI-compatible API endpoint
  3. 03Chat and image generation
  4. 04List models and free options
  5. 05Check live pricing and transparency

Use cases

  1. 01Switch existing OpenAI code to NovAI
  2. 02Call Chinese models from an MCP client
  3. 03Generate images through the SDK
  4. 04Compare model pricing

MCP support

The MCP server exposes tools for model listing, chat, image generation, free-model discovery, pricing, and service transparency. MCP clients can use these tools with a NovAI API key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "vvvvking-novai-python": {
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}
Run commanduvx aiapi-pro
Environment variables to set
NOVAI_API_KEYSecretNovAI API key. Get $2 free credit (no card) at https://aiapi-pro.com/register

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiaiapi-pro0.1.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.