NovAI - Chinese AI Models Gateway

io.github.vvvvkingv0.1.1更新于 Oct 10, 2026

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

已验证STDIO仅桌面AI & MLMedia & Design

概览

AI 生成的概览

让助手通过一个 OpenAI 兼容端点调用 120 多个中国前沿 AI 模型,用于对话和图像生成。

功能
这是一个本地 MCP 服务器,把 NovAI 的 OpenAI 兼容模型网关封装为工具,包括 novai_list_models、novai_chat、novai_generate_image、novai_free_models、novai_cheapest、novai_pricing_feed 和 novai_transparency。覆盖 DeepSeek、Qwen、GLM、Kimi、MiniMax、Hunyuan 等模型,并提供使用同一 base URL 的 Python SDK。
适用场景
当助手需要调用中国前沿模型进行对话或图像生成,又不想逐个对接各家供应商时;或希望在客户端内比较实时模型价格时使用。
运行要求
需要 Python 及 aiapi-pro 包(导入名 novai),以本地 stdio 进程运行。必须设置 NOVAI_API_KEY 环境变量,注册可获赠额度。需要访问供应商端点的网络连接。
安装前请注意
NOVAI_API_KEY 是可计费凭据,会发送给第三方网关;超出免费额度后按量付费,并有最低充值要求。图像生成可能带有可见的 AI 生成水印。提示词和生成内容会发送给该服务商。

安装

在 SourceWeft 中

  1. 打开 控制台中的 NovAI - Chinese AI Models Gateway,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源:README.md,提交 84d4caf

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.1.1最新Oct 10, 2026