Chuyển đến nội dung chính

Tổng quan

Hầu hết các ứng dụng AI chat thông thường đều kết nối với TokenLab thông qua đường dẫn chat tương thích với OpenAI tiêu chuẩn. Trên thực tế, điều đó có nghĩa là:
  • sử dụng https://api.tokenlab.sh/v1 làm URL cơ sở (base URL) trừ khi ứng dụng yêu cầu cụ thể một URL endpoint đầy đủ
  • sử dụng API key TokenLab của bạn như API key theo phong cách OpenAI
  • chọn các model mà ứng dụng có thể sử dụng trong quy trình chat tiêu chuẩn
Các ứng dụng chat thông thường thường hướng tới chat-completions, không phải là các client WebSocket cho Codex Responses. Đối với Codex CLI/App, Cursor hoặc các công cụ lập trình khác cần hành vi cụ thể của Responses, hãy sử dụng các hướng dẫn tích hợp chuyên biệt thay thế.
Loại: Ứng dụng ChatĐường dẫn chính: Chat-completions tương thích với OpenAIĐộ tin cậy hỗ trợ: Đường dẫn được hỗ trợ

Các ứng dụng được hỗ trợ

Ứng dụngNền tảngGhi chú
Open WebUIWeb, Self-hostedLựa chọn self-hosted phổ biến với các kết nối tương thích OpenAI
LibreChatWeb, Self-hostedKhông gian làm việc chat đa nhà cung cấp với các endpoint OpenAI tùy chỉnh
LobeChatWeb, Desktop, Self-hostedHỗ trợ nhà cung cấp tùy chỉnh mạnh mẽ
Cherry StudioWindows, macOS, LinuxLuồng nhà cung cấp tương thích OpenAI tốt
ChatboxWindows, macOS, LinuxThiết lập tương thích OpenAI đơn giản
DeepChatWindows, macOS, LinuxClient desktop với cài đặt nhà cung cấp tương thích OpenAI
JanDesktop, Self-hostedỨng dụng ưu tiên cục bộ với các nhà cung cấp OpenAI từ xa
TypingMindWeb, DesktopSử dụng kiểu endpoint tùy chỉnh
NextChatWeb, Self-hostedClient kiểu ChatGPT nhẹ với các ghi đè base-URL
ChatWiseWindows, macOSMẫu nhà cung cấp tùy chỉnh tiêu chuẩn

Các giá trị kết nối mặc định

TrườngGiá trị
Base URLhttps://api.tokenlab.sh/v1
API Keysk-your-tokenlab-key
API TypeOpenAI Compatible
Nếu một ứng dụng yêu cầu URL endpoint đầy đủ thay vì URL cơ sở, hãy sử dụng:
  • Chat Completions: https://api.tokenlab.sh/v1/chat/completions

Thiết lập ứng dụng ví dụ

LobeChat Self-hosted
OPENAI_API_KEY=sk-your-tokenlab-key
OPENAI_PROXY_URL=https://api.tokenlab.sh/v1
LobeChat Cloud
  1. Mở SettingsAI Service Provider
  2. Chọn OpenAI
  3. Nhập API key TokenLab của bạn
  4. Đặt endpoint tùy chỉnh thành https://api.tokenlab.sh/v1

Các model mặc định an toàn hơn

Danh mụcModel gợi ý
Mặc định chunggpt-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

Mẹo

Hầu hết các ứng dụng dễ cấu hình hơn và ít lỗi hơn khi bạn cung cấp https://api.tokenlab.sh/v1 làm base URL thay vì URL endpoint đầy đủ.
Hãy bắt đầu với gpt-5.4-mini hoặc deepseek-v4-flash cho các tác vụ chat hàng ngày, sau đó chuyển các tác vụ suy luận nặng hơn sang gpt-5.4 hoặc claude-opus-4-8.
Các ứng dụng chat thông thường và các tác nhân lập trình (coding agents) thường cần hành vi endpoint khác nhau. Hãy giữ các công cụ kiểu Codex/Cursor trên các trang tích hợp chuyên biệt của chúng.

Khắc phục sự cố

  • Xác minh base URL chính xác là https://api.tokenlab.sh/v1
  • Xóa dấu gạch chéo ở cuối nếu ứng dụng tự động thêm đường dẫn
  • Nếu ứng dụng yêu cầu URL endpoint đầy đủ, hãy sử dụng https://api.tokenlab.sh/v1/chat/completions
  • Kiểm tra kỹ API key của bạn
  • Xác nhận key đang hoạt động trong bảng điều khiển TokenLab
  • Đảm bảo không có khoảng trắng hoặc ngắt dòng thừa
  • Xác minh chính xác tên model
  • Thử một model mặc định được hỗ trợ rộng rãi như gpt-5.4-mini, deepseek-v4-flash hoặc claude-sonnet-5
  • Kiểm tra tính khả dụng hiện tại trong tài liệu hoặc bảng điều khiển TokenLab