快速开始

从拿到账号到完成第一次调用。全程约 5 分钟。

第一步：准备一个 API Key

无论你是要接工具还是写代码，都从这三件事开始。

登录 — 用 GSS 分配的账号登录 www.tokenroute.com。企业账号由 GSS 统一开通，无需自行注册。
确认额度 — 进入额度与 API Key，确认账户或所属部门已有可用额度。额度为空时调用会直接失败。
创建 API Key — 在同一页面创建并复制 Key，形如 sk- 开头的一串字符。Key 只在创建时完整显示一次，请立即妥善保存。

企业管理员

如果你需要先建部门、邀请员工、分配额度，见获取 API Key。

第二步：记下 Base URL

所有请求都发往同一个入口：

https://api.smartwan.com

关于 api.tokenroute.com

https://api.tokenroute.com 是本平台的正式接口域名，目前尚未启用。在启用公告发布前，请统一使用 api.smartwan.com，两者届时会并行提供服务，无需修改 API Key。

不同协议只是路径不同，Base URL 是同一个：

你要调用的	完整地址
OpenAI 兼容对话	`https://api.smartwan.com/v1/chat/completions`
Anthropic Messages	`https://api.smartwan.com/v1/messages`
Google Gemini	`https://api.smartwan.com/v1beta/models/{model}:generateContent`
图片生成	`https://api.smartwan.com/v1/images/generations`

填写客户端工具时，通常填 https://api.smartwan.com 或 https://api.smartwan.com/v1，以工具的提示为准——有的工具会自动补 /v1，重复填写会导致 404。

第三步：选一条路走

我想在工具里用

Chatbox、Cherry Studio 这类客户端，或 Claude Code、Codex 这类命令行工具。

在工具总览里挑一个，按对应页面填 API Key、Base URL、模型名
发一句「你好」
能收到回复即接入成功

我想在代码里调

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

返回里出现模型回复的文本，就说明打通了。Python、Node.js 及其他协议的写法见第一次调用。

先验证 Key 是否可用

不确定 Key 或网络是否正常时，先请求模型列表——这是最轻量的探针，不消耗额度：

curl https://api.smartwan.com/v1/models \
  -H "Authorization: Bearer sk-你的Token"

能返回模型列表就说明 Key 和网络都没问题。否则：

返回	原因	怎么办
`401`	Key 无效或请求头写错	检查是否漏了 `Bearer` 前缀，或 Key 已被删除
`403`	无权限或额度耗尽	到额度与 API Key 查看余额
`404`	地址写错	检查是否多写或漏写了 `/v1`
连接超时	网络不通	确认能访问 `api.smartwan.com`

选哪个模型

模型名必须和模型列表完全一致，大小写和连字符都不能差——写成 DeepSeek-V4-Flash 会直接 404，正确的是 deepseek-v4-flash。

不知道选什么就先用 deepseek-v4-flash，日常对话和代码任务都够用，响应也快。需要更强推理时换 deepseek-v4-pro、claude-sonnet-5 或 gpt-5.5。

接下来

获取 API Key — 企业管理员建部门、分配额度的完整流程
工具总览 — 各客户端和 CLI 工具的接入方法
第一次调用 — 四种协议的完整示例
常见问题 — 报错了看这里

第一步：准备一个 API Key​

第二步：记下 Base URL​

第三步：选一条路走​

我想在工具里用​

我想在代码里调​

先验证 Key 是否可用​

选哪个模型​

接下来​