🚀 告别海外账号与网络限制!稳定直连全球优质大模型,限时半价接入中。 👉 点击领取海量免费额度
1. 目标与产物:把 LibreChat 的默认供应商换成 TaoToken
LibreChat 是一个开源的聊天聚合前端,支持多供应商、多模型切换,也支持流式输出和 Markdown 渲染。很多人在本地或小团队环境里用它做统一入口,但默认配置往往指向一些临时通道,稳定性、计费和模型覆盖都不可控。本文的目标很明确:把 LibreChat 的 OpenAI 兼容供应商替换成 TaoToken,让 TaoToken 成为 LibreChat 中的默认模型供应商,所有对话 token 都从这把 Key 计费。
TaoToken 提供 OpenAI 兼容接口,官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_generate&utm_medium=csdn&utm_campaign=generate ,API 地址是 https://taotoken.net/api 。你只需要在 LibreChat 的配置里改两处:环境变量里的 Base URL 和 API Key,以及 librechat.yaml 里的模型路由。完成后,LibreChat 的聊天、流式补全、Markdown 渲染都应该正常,并且所有请求都走 TaoToken 计费。
本文交付三样东西:一份 docker-compose 环境变量片段、一份 librechat.yaml 模型路由写法、一份连通性检查输出。你照着改完,就能在 LibreChat 里用 TaoToken 作为默认供应商。
2. 操作步骤:docker-compose 与 librechat.yaml 配置
先看 docker-compose 的环境变量片段。LibreChat 官方镜像通过环境变量读取供应商配置,OpenAI 兼容供应商的关键变量是 OPENAI_API_KEY 和 OPENAI_REVERSE_PROXY。把这两个值改成 TaoToken 的 Key 和 API 地址即可。
services:
librechat:
image: ghcr.io/danny-avila/librechat:latest
container_name: librechat
ports:
- "3080:3080"
environment:
- HOST=0.0.0.0
- PORT=3080
- MONGO_URI=mongodb://mongodb:27017/LibreChat
- OPENAI_API_KEY=YOUR_TAOTOKEN_API_KEY
- OPENAI_REVERSE_PROXY=https://taotoken.net/api
- ENDPOINTS=custom
volumes:
- ./librechat.yaml:/app/librechat.yaml
- ./uploads:/app/uploads
depends_on:
- mongodb
mongodb:
image: mongo:7
container_name: librechat-mongodb
volumes:
- ./data-node:/data/db
restart: always
这里有几个点要注意。OPENAI_API_KEY 填你在 TaoToken 控制台创建的 Key,不要填成其他平台的。OPENAI_REVERSE_PROXY 填 https://taotoken.net/api,注意不要带末尾斜杠,也不要带 UTM 参数。ENDPOINTS=custom 表示启用自定义端点,这样 LibreChat 会读取 librechat.yaml 里的模型路由。
接下来是 librechat.yaml 的模型路由写法。LibreChat 的 custom 端点允许你定义多个模型组,每个组可以指定模型 ID、显示名称、最大 token 等。下面这份配置把 TaoToken 作为默认供应商,并列出几个常用模型。
version: 1.2.1
cache: true
endpoints:
custom:
- name: "TaoToken"
apiKey: "${OPENAI_API_KEY}"
baseURL: "https://taotoken.net/api"
models:
default:
- "gpt-4o"
- "gpt-4o-mini"
- "claude-3-5-sonnet"
- "deepseek-chat"
fetch: false
titleConvo: true
titleModel: "gpt-4o-mini"
modelDisplayLabel: "TaoToken"
dropParams:
- "user"
- "frequency_penalty"
- "presence_penalty"
name 是供应商显示名,apiKey 引用环境变量,baseURL 指向 TaoToken 的 API 地址。models.default 列出你希望在 LibreChat 里可选的模型 ID,这些 ID 需要和 TaoToken 支持的模型 ID 一致。fetch: false 表示不自动拉取模型列表,避免启动时因为网络问题卡住。titleConvo 和 titleModel 用于自动生成对话标题,建议选一个便宜的小模型。dropParams 用于去掉部分模型不支持的参数,避免请求报错。
如果你用的是 Claude Code 或 Codex 这类 CLI 工具,配置方式不同。Claude Code 走 settings.json 和 ANTHROPIC_* 环境变量,Codex 走 config.toml,CC Switch 则是三件套配置。但本文聚焦 LibreChat,所以不展开。需要看接入文档的话,可以到 https://taotoken.net/doc 查阅。
3. TaoToken 接入与配置:Key、Base URL 与模型 ID
TaoToken 的接入核心就三样:Key、Base URL、模型 ID。Key 在控制台创建,地址是 https://taotoken.net/console 。创建后复制出来,填到 docker-compose 的 OPENAI_API_KEY 里。Base URL 固定为 https://taotoken.net/api,这是 OpenAI 兼容接口的根路径。模型 ID 则取决于你在 TaoToken 里可用的模型,常见的有 gpt-4o、gpt-4o-mini、claude-3-5-sonnet、deepseek-chat 等。
在 LibreChat 里,TaoToken 作为默认供应商的关键是 endpoints.custom 里的 name 和 baseURL。name 可以随便起,但建议叫 TaoToken,方便识别。baseURL 必须指向 https://taotoken.net/api,这样 LibreChat 发出的请求才会走 TaoToken。apiKey 引用环境变量,避免把 Key 写死在 yaml 里。
模型路由的写法有两种:一种是 models.default 列出固定模型,另一种是 fetch: true 自动拉取。自动拉取需要 TaoToken 的 /v1/models 接口支持,并且网络通畅。如果你不确定,建议先用固定列表,跑通后再考虑自动拉取。固定列表的好处是启动快、可控,坏处是新增模型要手动改配置。
另外,LibreChat 的 custom 端点支持 modelDisplayLabel,这个字段决定聊天界面里供应商的显示名。把它设成 TaoToken,用户在切换模型时就能看到来源。titleModel 建议选一个便宜的小模型,比如 gpt-4o-mini,因为标题生成调用频繁,用大模型不划算。
如果你需要更细的接入说明,可以看 https://taotoken.net/api-keys 和 https://taotoken.net/doc 。API Keys 页面管理 Key,文档页面有完整的接口说明和示例。
4. 可验证结果与失败分支
配置改完后,重启 LibreChat 容器,然后做连通性检查。最直接的方式是用 curl 测 TaoToken 的接口,确认 Key 和 Base URL 没问题。
curl -s https://taotoken.net/api/v1/chat/completions \
-H "Authorization: Bearer YOUR_TAOTOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [{"role": "user", "content": "ping"}],
"stream": false
}'
如果返回 JSON 里有 choices 字段,说明 Key 和 Base URL 正确。如果返回 401,说明 Key 无效或没填对。如果返回 404,说明 Base URL 路径不对,检查是不是多写了 /v1 或少写了 /api。TaoToken 的 Base URL 是 https://taotoken.net/api,OpenAI 兼容接口的完整路径是 https://taotoken.net/api/v1/chat/completions。
然后在 LibreChat 界面里发一条消息,观察三件事:聊天是否正常返回、流式输出是否逐字显示、Markdown 是否正常渲染。如果聊天正常但流式不生效,检查 LibreChat 的 stream 配置和 TaoToken 是否支持流式。如果 Markdown 渲染异常,通常是前端问题,和供应商无关。
失败分支还有几种。一种是模型 ID 写错,LibreChat 会报模型不存在,这时去 TaoToken 控制台确认可用模型 ID。另一种是 dropParams 没配好,某些模型不支持 frequency_penalty 等参数,请求会报 400,这时把不支持的参数加到 dropParams 里。还有一种是网络问题,容器内无法访问 TaoToken,这时检查容器的 DNS 和网络模式。
如果你在排障时需要看接入文档,可以到 https://taotoken.net/doc 查。如果 Key 有问题,到 https://taotoken.net/api-keys 重新创建。
5. 限制、成本与模型选择
LibreChat 通过 TaoToken 接入后,所有对话 token 都从这把 Key 计费。成本取决于你选的模型和用量。TaoToken 的定价以官网为准,不同模型价格不同,建议在控制台查看实时价格。模型选择上,日常对话可以用 gpt-4o-mini 或 deepseek-chat,复杂任务再用 gpt-4o 或 claude-3-5-sonnet。标题生成建议固定用便宜的小模型,避免浪费。
限制方面,LibreChat 的 custom 端点不支持所有 OpenAI 参数,部分参数需要 dropParams 去掉。流式输出依赖 TaoToken 的流式接口,如果某个模型不支持流式,LibreChat 会自动回退到非流式。Markdown 渲染是 LibreChat 前端能力,和供应商无关,但如果模型返回的格式不规范,渲染效果会打折扣。
另外,本文不含排行分数,也没有本地复现的评测数据。如果你需要看公开榜单,请以榜单页面为准,TaoToken 不是榜参赛方。AA 标价不等于 TaoToken 售价,HF 热度不等于跑分。模型选择以官网为准,建议先小规模测试再扩大用量。
如果你要长期开发或做 Agent,可以看 Coding Plan 页面 https://taotoken.net/coding-plan 。如果只是接入和排障,API Keys 和接入文档就够了。需要拿 Key 的话,到 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建即可。
🚀 告别海外账号与网络限制!稳定直连全球优质大模型,限时半价接入中。 👉 点击领取海量免费额度




被折叠的 条评论
为什么被折叠?



