获取 API Key

调用 TokenRoute 的唯一凭证是 API Key。你走哪条流程，取决于你的角色。

你的角色	你要做的
员工 / 部门管理员	直接看创建 API Key
企业管理员（首次开通企业）	从初始化企业开始

企业账号由 GSS 统一开通，均不支持自行注册。

创建 API Key

登录控制台后：

进入左侧菜单额度与 API Key
确认额度充足——额度为 0 时创建的 Key 无法调用
点击创建，复制并保存

妥善保存 Key

创建后请妥善保存。对于有读取权限且状态允许的 Key，可在“额度与 API Key”中再次复制；按钮是否可用取决于权限和 Key 状态。不要把 Key 写进代码仓库、截图或聊天记录。

创建时可以设置的几项：

选项	建议
名称	按用途区分，如「本地开发」「生产服务」，便于日后排查用量
可用模型	默认为管理员授予你的全部模型；可再按厂商或按模型收窄，范围外的调用会被拒绝。若提示没有可用模型，说明授权的模型已下线，联系管理员重新配置即可
额度	可设一次性额度、每月额度或不限。用尽后该 Key 停止响应，可随时调整
有效期	对外协作的 Key 建议设 30–90 天并定期轮换

创建时可设置有效期；创建后的可编辑项目以当前界面提供的字段为准。

拿到 Key 之后填哪里

Key 到手就能用，只需两个信息：API Key 和 Base URL。

Base URL 取决于客户端如何拼接路径，按所用客户端配置：

你要接入的	Base URL	备注
Chatbox、Cherry Studio	`https://api.smartwan.com`	工具会自动补 `/v1`
Cline、Codex CLI	`https://api.smartwan.com/v1`	OpenAI 兼容协议
Claude Code	`https://api.smartwan.com`	Anthropic 协议，不加 `/v1`
OpenAI Python SDK	`https://api.smartwan.com/v1`	见下方示例
Anthropic Python SDK	`https://api.smartwan.com`	SDK 自动追加 `/v1/messages`
Google GenAI Python SDK	`https://api.smartwan.com`	设置 `api_version="v1beta"`

核对完整路径

多写或漏写版本路径可能导致请求失败；不同 SDK 的拼接方式见认证与 Base URL。404 的原因还需结合错误响应判断。

先验证 Key 可用

运行下方 Bash 示例前，在当前终端设置 export TOKENROUTE_API_KEY="sk-你的Token"。

下面的目录请求读取当前终端中已设置的 Key：

curl https://api.smartwan.com/v1/models \
  -H "Authorization: Bearer ${TOKENROUTE_API_KEY}"

返回列表说明这次目录请求通过，不代表具体模型推理必然成功。失败时结合状态码、error.code/type/message 和 Key 权限排查。

代码里怎么用

curl
Python
Node.js
环境变量

curl https://api.smartwan.com/v1/chat/completions \
  -H "Authorization: Bearer ${TOKENROUTE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的Token",
    base_url="https://api.smartwan.com/v1",
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-你的Token',
  baseURL: 'https://api.smartwan.com/v1',
});

const resp = await client.chat.completions.create({
  model: 'deepseek-v4-flash',
  messages: [{ role: 'user', content: '你好' }],
});
console.log(resp.choices[0].message.content);

CLI 工具多数读环境变量，写进 ~/.zshrc 或 ~/.bashrc 可持久生效：

# OpenAI 兼容（读取这些变量的客户端）
export OPENAI_API_KEY="sk-你的Token"
export OPENAI_BASE_URL="https://api.smartwan.com/v1"

# Anthropic 协议（Claude Code）
export ANTHROPIC_AUTH_TOKEN="sk-你的Token"
export ANTHROPIC_BASE_URL="https://api.smartwan.com"

Codex CLI 使用本页已验证的 TOKENROUTE_API_KEY + env_key 配置，具体见 Codex CLI。

Windows PowerShell 用 $env:OPENAI_API_KEY="sk-你的Token"。

模型名从模型列表点击复制，大小写和连字符必须完全一致。

不要把 Key 写进代码仓库

生产环境用环境变量或密钥管理服务读取，不要硬编码后提交到 Git。Key 泄露后到控制台删除重建即可。

初始化企业（管理员）

仅企业管理员首次开通时需要。

1. 完善企业信息

用 GSS 分配的管理员账号登录，进入 企业中心，填写企业名称并完成企业邮箱绑定。邮箱域名决定了后续员工能用什么邮箱注册。

2. 创建部门

进入 账户管理 → 创建部门，按组织架构建部门。部门是额度分配和用量统计的基本单位。

3. 邀请员工

在 企业中心 生成部门专属注册链接，发给待加入的员工。员工通过链接注册后自动归属该部门。

把某位员工设为部门管理员后，该部门的成员邀请、额度二次分配都可以由他接手，管理员不必事事经手。

4. 分配额度

进入额度与 API Key，为部门或员工分配额度。

额度是逐级下发的：企业 → 部门 → 员工 → 单个 Key。上级没分配，下级就无额度可用；给某个 Key 设的额度也不能超过其归属员工的可用额度。

先分额度，再建 Key

员工账户额度为空时，即使 Key 创建成功也会调用失败。开通新部门时记得先把额度配下去。

常见状况

员工说创建不了 Key — 多半是所属部门还没分到额度，到「额度与 API Key」给该部门配额。

Key 丢了 — 先检查“额度与 API Key”是否提供再次复制入口；权限或状态不允许时联系管理员。怀疑泄露时按管理流程轮换，并更新使用方。

想知道谁花了多少 — 控制台「用量中心」可按部门、员工、密钥、模型多维度查看，也能导出 CSV。

接下来

工具总览 — 各客户端和 CLI 的详细配置步骤
第一次调用 — Anthropic、Gemini 等其他协议的完整示例
常见问题 — 报错了看这里

创建 API Key​

拿到 Key 之后填哪里​

先验证 Key 可用​

代码里怎么用​

初始化企业（管理员）​

1. 完善企业信息​

2. 创建部门​

3. 邀请员工​

4. 分配额度​

常见状况​

接下来​