mcpField
9
9router

9router

github.com/decolua开发31.6k214 次安装今天更新
代码仓库

关于 9router

9router 是用于通过兼容 OpenAI 的 REST API 使用本地或远程 AI 网关的技能，可查询模型能力，并在多个提供方间路由请求及自动回退。

主要功能

  1. 01兼容 OpenAI 的 REST 请求
  2. 02按能力发现模型
  3. 03提供方组合与自动回退
  4. 04聊天、图像、语音、嵌入和网页技能

适用场景

  1. 01查找特定能力的模型 ID
  2. 02通过配置的网关路由请求
  3. 03提供方不可用时使用回退组合

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/decolua/9router --skill 9router

安装后在 Claude Code 中输入/9router确认已加载。

详细介绍

9Router

本地或远程 AI 网关，提供与 OpenAI 兼容的 REST 接口。一个密钥，支持多个提供方，自动回退。

设置

export NINEROUTER_URL="http://localhost:20128"      # or VPS / tunnel URL
export NINEROUTER_KEY="sk-..."                      # from Dashboard → Keys (only if requireApiKey=true)

所有请求：${NINEROUTER_URL}/v1/...，请求头为 Authorization: Bearer ${NINEROUTER_KEY}（若已禁用认证则省略）。

验证：curl $NINEROUTER_URL/api/health → {"ok":true}

发现模型

curl $NINEROUTER_URL/v1/models                  # chat/LLM (default)
curl $NINEROUTER_URL/v1/models/image            # image-gen
curl $NINEROUTER_URL/v1/models/tts              # text-to-speech
curl $NINEROUTER_URL/v1/models/embedding        # embeddings
curl $NINEROUTER_URL/v1/models/web              # web search + fetch (entries have `kind` field)
curl $NINEROUTER_URL/v1/models/stt              # speech-to-text
curl $NINEROUTER_URL/v1/models/image-to-text    # vision

将 data[].id 用作请求中的 model 字段。组合模型以 owned_by:"combo" 的形式出现。

响应结构：

{ "object": "list", "data": [
  { "id": "openai/gpt-5", "object": "model", "owned_by": "openai", "created": 1735000000 },
  { "id": "tavily/search", "object": "model", "kind": "webSearch", "owned_by": "tavily", "created": 1735000000 }
]}

能力技能

当用户需要某项特定能力时，从对应的原始 URL 获取该技能的 SKILL.md：

能力原始 URL
聊天 / 代码生成https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-chat/SKILL.md
图像生成https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-image/SKILL.md
文本转语音https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-tts/SKILL.md
语音转文本https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-stt/SKILL.md
嵌入https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-embeddings/SKILL.md
网页搜索https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-web-search/SKILL.md
网页抓取（URL → Markdown）https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-web-fetch/SKILL.md

错误

  • 401 → 设置或刷新 NINEROUTER_KEY（控制台 → Keys）
  • 400 Invalid model format → 检查 model 是否存在于 /v1/models/<kind> 中
  • 503 All accounts unavailable → 等待 retry-after 时长，或添加另一个提供方账户

评论

支持 Markdown