Nova RouterNova Router
快速入门API 文档接入 Agent 工具

快速入门

五分钟接入 Nova Router,获取 API Key、调用第一个模型并连接常用工具

五分钟接入 Nova Router,获取 API Key,调用第一个 AI 模型,并把它接入你的开发工具或客户端。

Nova Router 是一个统一的 AI 接入网关,兼容 OpenAI API 格式。你只需要一个 API Key,以及与你所用客户端对应的 Base URL,就能用同一套接口访问多种主流模型。

一、五分钟接入三步走

Step 1 - 获取你的 API Key

1.1 登录控制台

打开 https://router.bit-tech.com.cn 并进入控制台。

1.2 创建令牌

进入令牌管理,创建一个新的 API 令牌。

令牌列表

创建令牌

1.3 复制地址和 API Key

  • OpenAI 兼容 Base URL:https://router.bit-tech.com.cn/v1
  • Claude Code Base URL:https://router.bit-tech.com.cn
  • API Key:sk-...

重要提示

API Key 创建后请立即保存;如果遗失,请重新创建新令牌。

Base URL 说明

不同客户端对 Base URL 的定义不同:

  • OpenAI 兼容客户端(如 Codex CLI、Cherry Studio)通常使用带 /v1 的接口地址
  • Claude Code 通常使用站点根地址,不带 /v1

Step 2 - 调用第一个 API

2.1 用 curl 快速验证

curl https://router.bit-tech.com.cn/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer sk-你的APIKey" -d '{  "model": "gpt-4o",  "messages": [    { "role": "user", "content": "你好,介绍一下你自己" }  ]}'

2.2 用 Python(OpenAI SDK)

from openai import OpenAIclient = OpenAI(  base_url="https://router.bit-tech.com.cn/v1",  api_key="sk-你的APIKey",)response = client.chat.completions.create(  model="gpt-4o",  messages=[{"role": "user", "content": "你好,介绍一下你自己"}],)print(response.choices[0].message.content)

2.3 查询可用模型

curl https://router.bit-tech.com.cn/v1/models -H "Authorization: Bearer sk-你的APIKey"

Step 3 - 接入你的工具

Claude Code

export ANTHROPIC_BASE_URL="https://router.bit-tech.com.cn"export ANTHROPIC_API_KEY="sk-你的APIKey"

Codex CLI

export OPENAI_BASE_URL="https://router.bit-tech.com.cn/v1"export OPENAI_API_KEY="sk-你的APIKey"

Cherry Studio

  1. 添加服务商
  2. 类型选择 OpenAI 兼容接口
  3. 填写 Base URL 和 API Key
  4. 添加想要使用的模型 ID

其他兼容 OpenAI 的工具

  • API 地址:https://router.bit-tech.com.cn/v1
  • API Key:你的令牌
  • 模型名称:从 /v1/models 查询

二、API 能力一览

API 端点说明
POST /v1/chat/completions对话补全
GET /v1/models查询可用模型
POST /v1/images/generations图像生成

完整说明请查看 API 接口

三、常见问题

怎么查看自己有哪些可用模型?

调用 /v1/models,返回里的 id 就是可直接调用的模型名。

401 Unauthorized 怎么排查?

先检查 Authorization: Bearer sk-... 是否填写正确,再确认令牌是否仍然有效。

403 Forbidden 怎么排查?

通常是模型权限、分组权限或实例策略限制导致,请先确认当前令牌可以访问目标模型。

去哪里看完整参数说明?

查看 API 接口 中的完整接口文档。

这篇文档对您有帮助吗?