企业官网建设流程全解析

1. ccswitch 查询 deepseek 用量时 endpoint 到底该填什么

ccswitch 是一个把多家大模型 API Key 集中管理的本地小工具，它最实用的能力之一，就是在切换供应商的同时顺手把账户余额、用量拉回来显示。很多人第一次配 deepseek 用量代码时会卡在同一个地方：endpoint 到底填官方地址还是中转地址？填错了要么一直转圈，要么直接报账户无效。

我先把结论说清楚：ccswitch 的用量查询走的是「余额接口」，它默认按 OpenAI 兼容格式去请求{{baseUrl}}/user/balance。也就是说，你只要把 baseUrl 换成 TaoToken 的 API 地址，再把 apiKey 换成 TaoToken 生成的 Key，deepseek 的用量就能和别的模型一起在 ccswitch 里统一查看。这对同时用 deepseek、Claude、GPT 的开发者特别省事，不用来回登录好几个后台。

这篇就按「能跟做」的标准来写：先讲清楚 ccswitch 里 deepseek 用量代码的调用链路，再给出可复制的 endpoint 配置片段，然后跑一次真实的用量拉取，最后把常见的 401、local proxy failed、reading choices 这些报错挨个排掉。你跟着走一遍，本地就能看到 deepseek 的余额和赠送额度。

需要提前说明的是，ccswitch 的用量查询本质是一次 GET 请求，返回体里带is_available和balance_infos两个关键字段。理解这两个字段，后面所有排错都会变得简单。下面进入配置环节。

2. TaoToken 前置准备：拿到 Base URL 和 API Key

在动 ccswitch 之前，得先把两样东西准备好：Base URL 和 API Key。TaoToken 的 API 地址是https://taotoken.net/api，注意这里不带任何查询参数，ccswitch 里填的就是这个根地址，后面的/user/balance由用量代码自己拼上去。

API Key 的获取路径是登录后进入控制台，在 API Keys 页面新建一个。建议给 ccswitch 单独建一个 Key，命名成ccswitch-balance之类，方便以后按用途吊销。新建完立刻复制，页面刷新后就看不到完整 Key 了。

这里有个容易踩的坑：ccswitch 的用量查询和实际对话请求可以共用同一个 Key，但如果你在 ccswitch 里既配了对话又配了余额查询，要确认两处填的 Key 是同一个，否则会出现「对话正常但余额显示账户无效」的割裂现象。我试过把两个 Key 混用，排查了半小时才发现是 Key 不一致。

准备好之后，你手里应该有：

如果你还想在 ccswitch 里同时管理对话模型，模型 ID 直接填deepseek-chat或deepseek-reasoner即可，Base URL 和 Key 与上面保持一致。这样一套配置既能查用量又能发请求，ccswitch 的三件套（Base URL + Key + Model ID）就齐了。

3. 可复制的 endpoint 配置与用量代码片段

ccswitch 的用量查询配置通常是一个 JSON 或 JS 对象，核心是request和extractor两部分。下面这份可以直接粘进 ccswitch 的自定义用量配置里，路径和字段名保持和原工具一致。

{ "request": { "url": "https://taotoken.net/api/user/balance", "method": "GET", "headers": { "Authorization": "Bearer {{apiKey}}", "User-Agent": "cc-switch/1.0" } }, "extractor": "function(response) {\n if (!response || response.is_available !== true) {\n return { isValid: false, invalidMessage: '账户无效或 API Key 错误' };\n }\n const balanceInfo = response.balance_infos && response.balance_infos[0];\n if (!balanceInfo) {\n return { isValid: false, invalidMessage: '未找到余额信息' };\n }\n const remaining = parseFloat(balanceInfo.total_balance);\n const currency = balanceInfo.currency || 'CNY';\n return {\n isValid: true,\n remaining: remaining,\n unit: currency,\n extra: '充值余额: ' + balanceInfo.topped_up_balance + ' ' + currency + ', 赠送余额: ' + balanceInfo.granted_balance + ' ' + currency\n };\n}" }

如果你更习惯用 TOML 风格的配置（部分 ccswitch 版本支持），可以写成这样：

[balance] base_url = "https://taotoken.net/api" path = "/user/balance" method = "GET" auth_header = "Authorization" auth_prefix = "Bearer " user_agent = "cc-switch/1.0"

关键点有三个。第一，url里不要出现{{baseUrl}}没被替换的情况，如果你在 ccswitch 里已经单独配了 baseUrl 变量，那就写{{baseUrl}}/user/balance，否则直接写完整地址更稳。第二，Authorization的格式必须是Bearer加空格再加 Key，少一个空格就会 401。第三，extractor里对total_balance做了parseFloat，因为接口返回的是字符串，不转数字 ccswitch 的进度条会显示异常。

把这段配置保存后，ccswitch 会在刷新时自动发起请求。你不需要手动点「测试」，它一般会在切换供应商或启动时触发一次。如果没触发，检查一下 ccswitch 的用量刷新开关是否打开。

4. 验证请求：本地跑通一次用量拉取并核对字段

配置写完不能只看界面，最好用命令行先验证一次，确认返回字段和 ccswitch 解析的一致。打开终端，把下面的命令里的 Key 换成你自己的：

curl -s -X GET "https://taotoken.net/api/user/balance" \ -H "Authorization: Bearer sk-你的Key" \ -H "User-Agent: cc-switch/1.0"

正常返回大概长这样：

{ "is_available": true, "balance_infos": [ { "currency": "CNY", "total_balance": "42.50", "topped_up_balance": "40.00", "granted_balance": "2.50" } ] }

拿到这个返回后，逐项核对：is_available必须是true，否则 ccswitch 会直接判账户无效；balance_infos是数组，取第一个元素；total_balance是字符串"42.50"，经过parseFloat后变成数字 42.5；currency是CNY。ccswitch 界面上的「剩余」显示的就是 42.5，「单位」显示 CNY，extra里会拼出充值余额和赠送余额。

如果 curl 能返回但 ccswitch 界面还是空，多半是extractor里的字段名写错了，比如把balance_infos写成了balance_info。这时候把 ccswitch 的日志打开，看它实际拿到的 response 是什么，对照着改字段名即可。

验证通过后，你在 ccswitch 里切换 deepseek 供应商时，余额就会实时刷新。多模型场景下，每个供应商配一份对应的用量代码，ccswitch 会分别请求各自的 endpoint，互不干扰。

5. 本篇常见报错排查：401、local proxy failed、reading choices

排错这块我按真实遇到的顺序列，基本都是配置层面的问题，不用改代码。

401 Unauthorized：最常见。九成是 Key 错了或者Bearer后面少了空格。先确认 Key 没有多余换行，再确认 header 拼出来是Bearer sk-xxx。还有一种情况是 Key 被吊销了，去控制台看一眼状态。如果对话能用但余额 401，说明你对话和余额用了两个不同的 Key，统一成一个。

local proxy failed：这个报错通常出现在 ccswitch 走了本地代理转发的时候。检查 ccswitch 的代理设置，如果开了本地代理端口，确认端口没被占用、代理进程还活着。另一种可能是 baseUrl 填成了带路径的地址，比如https://taotoken.net/api/v1，导致拼接后变成/api/v1/user/balance，路径不对自然失败。把 baseUrl 改回https://taotoken.net/api就好。

reading choices 报错：这个一般不是余额查询的问题，而是对话请求的返回体解析失败。ccswitch 在拉取模型列表或发对话请求时，如果 endpoint 指向了余额接口，就会拿不到choices字段。检查一下对话配置和用量配置是不是串了，对话的 baseUrl 应该指向兼容对话的路径，用量单独走/user/balance。

OAuth 相关报错：如果你在 ccswitch 里配了需要 OAuth 的供应商，又混用了 API Key 模式，会提示 OAuth token 无效。deepseek 用量查询走的是纯 API Key，不需要 OAuth，把 OAuth 开关关掉即可。

返回 is_available 为 false：Key 有效但账户状态异常，去控制台确认账户是否正常、是否有欠费。这种情况 ccswitch 会显示「账户无效或 API Key 错误」，但实际原因在账户侧。

排查时建议按「curl 能不能通 → ccswitch 日志有没有 response → extractor 字段对不对」这个顺序走，基本三步内能定位。

6. 把 deepseek 用量接进统一面板的下一步

配置跑通之后，你可以把同样的模式复制到其他模型上。ccswitch 的价值就在于一套 endpoint 配置模板能复用到多个供应商，只要对方的余额接口兼容is_available+balance_infos这套结构，extractor 几乎不用改。

如果你还想在 ccswitch 里直接发对话请求验证 Key 是否可用，可以打开模型对话页面发一条测试消息，确认对话链路和用量链路用的是同一套凭证。长期做编码或 Agent 任务的话，Coding Plan 能把用量和调用统一管理，省得每个模型单独对账。

接入过程中如果遇到 endpoint 拼接或字段解析的问题，接入文档里有完整的路径说明和返回示例，对照着改比盲试快得多。API Key 建议按用途分开建，ccswitch 用一个、脚本用一个，出问题好定位也好吊销。