快速入门
五分钟接入 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
- 添加服务商
- 类型选择 OpenAI 兼容接口
- 填写 Base URL 和 API Key
- 添加想要使用的模型 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 接口 中的完整接口文档。
这篇文档对您有帮助吗?