QUICK START

几分钟接入
NavRouter

兼容 OpenAI SDK，无需重写现有业务逻辑。准备一把 API 密钥，修改网关地址，即可开始调用。

创建 API 密钥

登录控制台，在 API 密钥页面创建新密钥。密钥仅在创建时完整显示，请立即保存。

安全提示不要将完整密钥提交到 Git 仓库或发送到不可信的服务。

配置环境变量

将网关地址与密钥写入环境变量，避免在业务代码中直接保存敏感凭据。

# PowerShell
$env:OPENAI_BASE_URL="https://your-domain.example/api/v1"
$env:OPENAI_API_KEY="sk-your-navrouter-key"

安装官方 SDK

NavRouter 使用 OpenAI 兼容接口，可直接使用熟悉的 OpenAI SDK 发起请求。

python -m pip install openai

发送第一条请求

指定模型名称后发起对话请求，即可在控制台查看调用量与费用记录。

from openai import OpenAI

client = OpenAI()
response = client.chat.completions.create(
    model="gpt-4.1",
    messages=[{"role": "user", "content": "Hello"}],
)

print(response.choices[0].message.content)