WorkBuddy khóa bên thứ ba — Hướng dẫn mô hình tùy chỉnh APIMaster.ai
Cách thêm khóa API OpenAI-compatible của APIMaster.ai trong WorkBuddy. Settings → Models → Add Model: Endpoint, API Key và Model Name, rồi chọn mô hình trong chat.
WorkBuddy là agent AI trên desktop. Kết nối APIMaster.ai qua API tương thích OpenAI trong Custom Models.
Trước hết hãy lấy API Key. Khóa chỉ lưu cục bộ tại
%USERPROFILE%\.workbuddy\models.jsonhoặc~/.workbuddy/models.json.
Điều kiện tiên quyết
- Đã cài WorkBuddy
- API Key từ console
- model id từ marketplace (vd.
gpt-5.6-sol)
Bước 1 — Mở cấu hình mô hình tùy chỉnh
Cách A (khuyến nghị) — bộ chọn mô hình chat:
- Nhấp tên mô hình cạnh ô nhập
- Ở cuối menu, Configure custom models

Cách B — từ Settings:
- Mở Settings
- Chọn Models
- Trong CUSTOM MODELS, + Add Model

File cục bộ: Windows %USERPROFILE%\.workbuddy\models.json / macOS·Linux ~/.workbuddy/models.json
Bước 2 — Điền thông tin kết nối APIMaster
Hộp thoại Add Model (OpenAI-compatible API required):
| Trường | Giá trị |
|---|---|
| Provider | Custom |
| Endpoint | https://apimaster.ai/v1 (bắt buộc /v1) |
| API Key | Khóa APIMaster của bạn |
| Model Name | model id chính xác từ marketplace |
Advanced Settings: Tool Calling ✅ / Image Input ✅ / Reasoning tùy chọn / Custom Protocol ❌

Nhấn Save. Model Name phải khớp chính xác id marketplace.
Bước 3 — Chọn trong chat
- Mở bộ chọn mô hình
- Trong Custom Models, chọn mô hình vừa thêm
- Gửi tin nhắn thử
- Tên mô hình cạnh phản hồi = thành công

Ví dụ model id
| model id | Notes |
|---|---|
gpt-5.6-sol |
GPT example in screenshots |
gpt-5.4 / gpt-5.5 |
GPT family |
claude-sonnet-4-6 |
Claude Sonnet |
claude-opus-4-8 |
Claude Opus |
deepseek-v4-pro / deepseek-v4-flash |
DeepSeek |
minimax-m3 / kimi-k3 |
Other popular models |
Copy ids from the marketplace.
Xử lý sự cố
| Vấn đề | Cách xử lý |
|---|---|
| 401 | Dán lại API Key rồi Save |
| 404 | Sao chép lại Model Name |
| Timeout | Endpoint = https://apimaster.ai/v1 |
| Custom Models trống | Kiểm tra Save; khởi động lại WorkBuddy |
| Tool lỗi | Bật Tool Calling |
| Không thấy cài đặt | Configure custom models hoặc Settings → Models → + Add Model |
Danh sách kiểm tra
- Đã cài WorkBuddy
- Provider = Custom
- Endpoint =
https://apimaster.ai/v1 - Model Name từ marketplace
- Tool Calling nếu cần + Save
- Chọn được trong Custom Models và trả lời OK