快速开始

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

第一步：准备一个 API Key

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

1. 登录 — 用 GSS 分配的账号登录 控制台。企业账号由 GSS 统一开通，无需自行注册。
2. 确认额度 — 进入 额度与 API Key，确认账户或所属部门已有可用额度。额度为空时调用会直接失败。
3. 创建 API Key — 在同一页面创建并复制 Key，形如 sk- 开头的一串字符。请妥善保存；状态与权限允许时，可在该页面再次复制。

企业管理员

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

第二步：记下 Base URL

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

https://api.smartwan.com

关于 api.tokenroute.com

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

下面列出完整请求地址；SDK 与客户端如何填写 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，重复填写可能导致请求失败。

第三步：选一条路走

我想在工具里用

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

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

我想在代码里调

以下命令在 Bash / Git Bash 运行，将占位 Key 换成自己的 Key。Windows PowerShell 和 SDK 示例见第一次调用。

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"

返回模型列表说明这次目录请求通过；具体模型推理还需单独验证。失败时结合错误响应排查：

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

选哪个模型

模型名必须和模型列表完全一致，大小写和连字符都不能差，例如使用 deepseek-v4-flash，不要自行改写为 DeepSeek-V4-Flash。错误状态码因路由而异。

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

接下来

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