> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.
# Ứng dụng AI Chat
> Cấu hình các ứng dụng AI chat phổ biến để sử dụng API tương thích với OpenAI của TokenLab
## 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ụng | Nền tảng | Ghi chú |
| ------------- | ------------------------- | -------------------------------------------------------------------------- |
| Open WebUI | Web, Self-hosted | Lựa chọn self-hosted phổ biến với các kết nối tương thích OpenAI |
| LibreChat | Web, Self-hosted | Không gian làm việc chat đa nhà cung cấp với các endpoint OpenAI tùy chỉnh |
| LobeChat | Web, Desktop, Self-hosted | Hỗ trợ nhà cung cấp tùy chỉnh mạnh mẽ |
| Cherry Studio | Windows, macOS, Linux | Luồng nhà cung cấp tương thích OpenAI tốt |
| Chatbox | Windows, macOS, Linux | Thiết lập tương thích OpenAI đơn giản |
| DeepChat | Windows, macOS, Linux | Client desktop với cài đặt nhà cung cấp tương thích OpenAI |
| Jan | Desktop, Self-hosted | Ứng dụng ưu tiên cục bộ với các nhà cung cấp OpenAI từ xa |
| TypingMind | Web, Desktop | Sử dụng kiểu endpoint tùy chỉnh |
| NextChat | Web, Self-hosted | Client kiểu ChatGPT nhẹ với các ghi đè base-URL |
| ChatWise | Windows, macOS | Mẫ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ường | Giá trị |
| -------- | ---------------------------- |
| Base URL | `https://api.tokenlab.sh/v1` |
| API Key | `sk-your-tokenlab-key` |
| API Type | OpenAI 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**
```bash theme={null}
OPENAI_API_KEY=sk-your-tokenlab-key
OPENAI_PROXY_URL=https://api.tokenlab.sh/v1
```
**LobeChat Cloud**
1. Mở **Settings** → **AI 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`
1. Mở **Settings** → **Model Provider**
2. Thêm một nhà cung cấp **OpenAI-compatible**
3. Nhập:
* **Name**: TokenLab
* **API Base URL**: `https://api.tokenlab.sh/v1`
* **API Key**: `sk-your-tokenlab-key`
4. Thêm các model bạn muốn sử dụng
1. Mở **Settings** → **AI Model**
2. Chọn **OpenAI API Compatible**
3. Nhập:
* **API Host**: `https://api.tokenlab.sh/v1`
* **API Key**: `sk-your-tokenlab-key`
* **Model**: `gpt-5.4-mini` hoặc `claude-sonnet-5`
1. Mở **Settings**
2. Chọn **Custom Endpoint**
3. Nhập:
* **Endpoint URL**: `https://api.tokenlab.sh/v1/chat/completions`
* **API Key**: `sk-your-tokenlab-key`
4. Cấu hình các model bạn muốn hiển thị
1. Mở **Admin Settings** → **Connections**
2. Thêm một kết nối **OpenAI-compatible**
3. Nhập:
* **Base URL**: `https://api.tokenlab.sh/v1`
* **API Key**: `sk-your-tokenlab-key`
4. Lưu và chọn các model bạn muốn hiển thị
1. Mở **Settings** -> **Model Provider**
2. Thêm một nhà cung cấp tương thích OpenAI
3. Nhập:
* **Base URL**: `https://api.tokenlab.sh/v1`
* **API Key**: `sk-your-tokenlab-key`
* **Model**: `gpt-5.4-mini`
4. Lưu và chạy thử nghiệm chat
1. Mở **Settings** -> **Providers**
2. Thêm một nhà cung cấp OpenAI từ xa tương thích
3. Nhập:
* **Provider name**: TokenLab
* **Base URL**: `https://api.tokenlab.sh/v1`
* **API Key**: `sk-your-tokenlab-key`
4. Chọn `gpt-5.4-mini` hoặc model TokenLab khác
Thêm một endpoint tương thích OpenAI vào cấu hình nhà cung cấp LibreChat của bạn và trỏ nó đến:
```yaml theme={null}
customEndpoints:
- name: TokenLab
apiKey: '${OPENAI_API_KEY}'
baseURL: 'https://api.tokenlab.sh/v1'
models:
default: ['gpt-5.4-mini', 'gpt-5.4', 'claude-sonnet-5']
fetch: false
```
## Các model mặc định an toàn hơn
| Danh mục | Model gợi ý |
| -------------- | ------------------------------------------------------ |
| Mặc định chung | `gpt-5.4-mini`, `gpt-5.4`, `gpt-5.5` |
| Anthropic | `claude-sonnet-5`, `claude-opus-4-8`, `claude-fable-5` |
| Google | `gemini-3.5-flash`, `gemini-3.1-flash-lite` |
| DeepSeek | `deepseek-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