AI 聊天应用 - TokenLab

概述

大多数通用 AI 聊天应用都通过标准的 OpenAI 兼容聊天路径连接到 TokenLab。实际配置时，这意味着：

使用 https://api.tokenlab.sh/v1 作为 base URL，除非应用明确要求填写完整的端点 URL
使用你的 TokenLab API key 作为 OpenAI 风格的 API key
选择应用可在标准聊天工作流中使用的模型

通用聊天应用通常是面向 chat-completions的，而不是 Codex Responses WebSocket 客户端。对于 Codex CLI/App、Cursor 或其他需要 Responses 特定行为的编码工具，请改用专门的集成指南。

类型: 聊天应用主要路径: OpenAI 兼容 chat-completions 路径支持级别: 支持路径

支持的应用

应用	平台	备注
Open WebUI	Web、自托管	流行的自托管选择，支持 OpenAI 兼容连接
LibreChat	Web、自托管	支持多提供方的聊天工作台，可接自定义 OpenAI 端点
LobeChat	Web、Desktop、自托管	强大的自定义提供方支持
Cherry Studio	Windows、macOS、Linux	良好的 OpenAI 兼容提供方流程
Chatbox	Windows、macOS、Linux	简单的 OpenAI 兼容配置
TypingMind	Web、Desktop	使用自定义端点风格
NextChat	Web、自托管	轻量的 ChatGPT 风格客户端，支持 base URL 覆盖
ChatWise	Windows、macOS	标准的自定义提供方模式

默认连接值

字段	值
基础 URL	`https://api.tokenlab.sh/v1`
API 密钥	`sk-your-tokenlab-key`
API 类型	OpenAI 兼容

如果应用要求填写完整的端点 URL而不是 base URL，请使用：

Chat Completions: https://api.tokenlab.sh/v1/chat/completions

应用配置示例

自托管 LobeChat

OPENAI_API_KEY=sk-your-tokenlab-key
OPENAI_PROXY_URL=https://api.tokenlab.sh/v1

LobeChat Cloud

打开 Settings → AI 服务提供方
选择 OpenAI
输入你的 TokenLab API key
将自定义端点设置为 https://api.tokenlab.sh/v1

打开 Settings → 模型提供方
添加一个 OpenAI 兼容 提供方
输入：
- Name: TokenLab
- API Base URL: https://api.tokenlab.sh/v1
- API Key: sk-your-tokenlab-key
添加你想使用的模型

打开 Settings → AI Model
选择 OpenAI API Compatible
输入：
- API Host: https://api.tokenlab.sh/v1
- API Key: sk-your-tokenlab-key
- Model: gpt-5-mini 或 gpt-4o

打开 Settings
选择 自定义端点
输入：
- 端点 URL: https://api.tokenlab.sh/v1/chat/completions
- API Key: sk-your-tokenlab-key
配置你希望公开的模型

打开 Admin Settings → Connections
添加一个 OpenAI 兼容 连接
输入：
- Base URL: https://api.tokenlab.sh/v1
- API Key: sk-your-tokenlab-key
保存后选择你要暴露的模型

在 LibreChat 的提供方配置里新增一个 OpenAI 兼容端点，并指向：

customEndpoints:
  - name: TokenLab
    apiKey: '${OPENAI_API_KEY}'
    baseURL: 'https://api.tokenlab.sh/v1'
    models:
      default: ['gpt-5-mini', 'gpt-5.4', 'claude-sonnet-4-6']
      fetch: false

更安全的默认模型

类别	推荐模型
通用默认	`gpt-5.4`, `gpt-5-mini`, `gpt-4o`
Anthropic	`claude-sonnet-4-6`, `claude-opus-4-6`
Google	`gemini-2.5-flash`, `gemini-2.5-pro`
DeepSeek	`deepseek-r1`, `deepseek-v3-2`

提示

当应用支持时，优先使用 base URL

当你提供 https://api.tokenlab.sh/v1 作为 base URL，而不是完整的端点 URL 时，大多数应用会更容易配置，也更不容易出错。

先使用较小的模型

日常聊天可先从 gpt-5-mini 或 gpt-4o 开始，然后再将更重的推理任务切换到 gpt-5.4 或 claude-opus-4-6。

将编码工具分开配置

通用聊天应用和编码代理通常需要不同的端点行为。请将 Codex/Cursor 风格的工具保留在各自专门的集成页面中进行配置。

故障排查

连接错误

确认 base URL 完全等于 https://api.tokenlab.sh/v1
如果应用会自动追加路径，请移除末尾斜杠
如果应用要求完整的端点 URL，请使用 https://api.tokenlab.sh/v1/chat/completions

401 Unauthorized

再次检查你的 API key
确认该 key 已在 TokenLab dashboard 中激活
确保没有多余的空格或换行

模型不可用

精确确认模型名称
尝试广泛支持的默认模型，例如 gpt-5-mini、gpt-4o 或 claude-sonnet-4-6
在 TokenLab 文档或 dashboard 中检查当前可用性

Documentation Index

​概述

​支持的应用

​默认连接值

​应用配置示例

​更安全的默认模型

​提示

​故障排查

概述

支持的应用

默认连接值

应用配置示例

更安全的默认模型

提示

故障排查