跳转到主要内容

概述

大多数通用 AI 聊天应用通过标准的 OpenAI 兼容聊天路径连接到 TokenLab。 在实践中,这意味着:
  • 使用 https://api.tokenlab.sh/v1 作为基础 URL(除非应用明确要求输入完整的端点 URL)
  • 使用您的 TokenLab API key 作为 OpenAI 风格的 API key
  • 选择应用可以在标准聊天工作流中使用的模型
通用聊天应用通常是面向聊天补全(chat-completions)的,而不是 Codex Responses WebSocket 客户端。对于需要特定 Responses 行为的 Codex CLI/App、Cursor 或其他编程工具,请使用专门的集成指南。
类型: 聊天应用主要路径: OpenAI 兼容的聊天补全(chat-completions)支持置信度: 支持的路径

支持的应用

应用平台备注
Open WebUIWeb, 自托管流行的自托管选择,支持 OpenAI 兼容连接
LibreChatWeb, 自托管具有自定义 OpenAI 端点的多提供商聊天工作区
LobeChatWeb, 桌面端, 自托管强大的自定义提供商支持
Cherry StudioWindows, macOS, Linux良好的 OpenAI 兼容提供商流程
ChatboxWindows, macOS, Linux简单的 OpenAI 兼容设置
DeepChatWindows, macOS, Linux带有 OpenAI 兼容提供商设置的桌面客户端
Jan桌面端, 自托管优先本地运行,支持远程 OpenAI 兼容提供商
TypingMindWeb, 桌面端使用自定义端点样式
NextChatWeb, 自托管轻量级 ChatGPT 风格客户端,支持基础 URL 覆盖
ChatWiseWindows, macOS标准自定义提供商模式

默认连接值

字段
Base URLhttps://api.tokenlab.sh/v1
API Keysk-your-tokenlab-key
API TypeOpenAI Compatible
如果应用要求输入完整端点 URL 而不是基础 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
  1. 打开 Settings(设置) → AI Service Provider(AI 服务提供商)
  2. 选择 OpenAI
  3. 输入您的 TokenLab API key
  4. 将自定义端点设置为 https://api.tokenlab.sh/v1

更安全的模型默认值

类别建议模型
通用默认gpt-5.4-mini, gpt-5.4, gpt-5.5
Anthropicclaude-sonnet-5, claude-opus-4-8, claude-fable-5
Googlegemini-3.5-flash, gemini-3.1-flash-lite
DeepSeekdeepseek-v4-flash, deepseek-v4-pro

提示

当您提供 https://api.tokenlab.sh/v1 作为基础 URL 而不是完整端点 URL 时,大多数应用更容易配置且更稳定。
日常聊天请先使用 gpt-5.4-minideepseek-v4-flash,然后将更繁重的推理任务交给 gpt-5.4claude-opus-4-8
通用聊天应用和编程代理通常需要不同的端点行为。请将 Codex/Cursor 风格的工具保留在它们专门的集成页面上。

故障排除

  • 验证基础 URL 是否完全为 https://api.tokenlab.sh/v1
  • 如果应用自动添加路径,请删除末尾的斜杠
  • 如果应用需要完整端点 URL,请使用 https://api.tokenlab.sh/v1/chat/completions
  • 仔细检查您的 API key
  • 确认该 key 在 TokenLab 控制面板中处于激活状态
  • 确保没有多余的空格或换行符
  • 验证模型名称是否完全正确
  • 尝试使用广泛支持的默认模型,如 gpt-5.4-minideepseek-v4-flashclaude-sonnet-5
  • 在 TokenLab 文档或控制面板中检查当前的可用性