Dùng TaiKhoanGiaRe trong Open WebUI, Cherry Studio và Chatbox

Hướng dẫn thêm TaiKhoanGiaRe làm provider OpenAI-compatible trong Open WebUI, Cherry Studio và Chatbox: base URL, API key, chọn model, ước tính chi phí.

Vì sao Open WebUI, Cherry Studio và Chatbox dùng được với TaiKhoanGiaRe

Cả ba app chat này đều hỗ trợ kiểu provider "OpenAI-compatible": bạn chỉ cần khai báo một base URL và một API key, app sẽ tự lấy danh sách model và gọi API theo chuẩn /v1/chat/completions. TaiKhoanGiaRe expose đúng chuẩn đó qua base URL https://taikhoangiare.vn/v1, nên không cần cài thêm plugin hay viết code gì cả.

Hướng dẫn chi tiết kèm ảnh chụp màn hình cho nhóm "App chat" (Open WebUI, Cherry Studio, Chatbox) nằm ở /integrations.html?app=chat. Bài này tóm lại các bước chính và thêm phần chọn model, tính chi phí.

Bước 1: Lấy API key từ TaiKhoanGiaRe

Mỗi tài khoản TaiKhoanGiaRe có đúng một secret key, được tạo tự động khi đăng ký ở /login.html. Để lấy key:

1. Đăng nhập, vào /dashboard.html.
2. Mở tab API keys, bấm Show để hiện secret key.
3. Copy key, dán tạm vào nơi an toàn (trình quản lý mật khẩu chẳng hạn).

Tab này cũng ghi rõ base URL cho SDK kiểu OpenAI là https://taikhoangiare.vn/v1 và base URL kiểu Anthropic là https://taikhoangiare.vn (không có /v1). Với Open WebUI, Cherry Studio, Chatbox thì dùng base URL kiểu OpenAI.

Nếu nghi key bị lộ, bấm Rotate để tạo key mới — lưu ý thao tác này vô hiệu hoá key cũ ngay, nên cập nhật lại trong cả ba app sau khi rotate.

Kiểm tra key hoạt động bằng cURL trước khi vào app

Nên test nhanh bằng cURL trước, tránh mất công mò lỗi trong UI của app chat:

curl https://taikhoangiare.vn/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Xin chào"}]
  }'

Nhận được phản hồi JSON có nội dung trả lời là key và model đều ổn. Nếu cần hướng dẫn chi tiết hơn về bước này, xem bài lấy API key và gọi thử bằng cURL.

Bước 2: Cấu hình Open WebUI

Trong Open WebUI, vào phần quản lý kết nối tới nhà cung cấp model dạng OpenAI API (thường nằm trong Settings → Connections):

1. Thêm một connection mới kiểu OpenAI API.
2. Điền API Base URL: https://taikhoangiare.vn/v1.
3. Điền API Key: dán key đã lấy ở Bước 1.
4. Lưu lại, Open WebUI sẽ tự fetch danh sách model từ endpoint /v1/chat/completions tương ứng.
5. Vào khung chat, chọn model (ví dụ claude-sonnet-5 hoặc gpt-5.5) và chat thử.

Bước 3: Cấu hình Cherry Studio

Cherry Studio cho phép thêm provider tuỳ chỉnh ngay trong phần cài đặt model:

1. Mở phần quản lý Providers, thêm provider mới kiểu tương thích OpenAI.
2. Nhập Base URL: https://taikhoangiare.vn/v1.
3. Nhập API Key: key của bạn.
4. Bấm nút lấy danh sách model (fetch models) hoặc thêm model id thủ công, ví dụ claude-opus-5-5, deepseek-v4-flash.
5. Chọn provider và model vừa thêm ở khung chat chính để bắt đầu dùng.

Bước 4: Cấu hình Chatbox

Chatbox cũng theo đúng mẫu provider OpenAI-compatible:

1. Vào Settings → chọn thêm model provider mới / tuỳ chỉnh.
2. Chọn kiểu API là OpenAI API.
3. Điền API Host: https://taikhoangiare.vn/v1.
4. Điền API Key: key của bạn.
5. Chọn hoặc nhập model id muốn dùng, lưu lại và bắt đầu chat.

Vì cả ba app dùng cùng một chuẩn, các bước gần như giống nhau: base URL + key + chọn model. Nếu bạn đã quen thao tác này, việc thêm app chat mới sau đó chỉ mất vài phút.

Chọn model nào và ước tính chi phí một tin nhắn

Danh sách đầy đủ model cùng giá niêm yết theo 1 triệu token nằm ở /models.html, có filter theo khả năng vision/tools/reasoning. Dưới đây là chi phí cho một tin nhắn chat điển hình (1.000 token input + 500 token output), tính theo giá đang bán trên TaiKhoanGiaRe:

Nếu dùng app chat chủ yếu để trò chuyện ngắn, hỏi đáp hàng ngày thì deepseek-v4-flash rất rẻ. Nếu cần chất lượng suy luận cao hơn cho công việc, claude-sonnet-5 hoặc gpt-5.5 là lựa chọn hợp lý hơn. Prompt caching được bật sẵn trên TaiKhoanGiaRe nên nếu app giữ lại context dài (ví dụ hệ thống prompt cố định), phần đọc lại từ cache được tính giá thấp hơn giá input thông thường.

Nạp credit để dùng

TaiKhoanGiaRe tính phí theo credit trả trước, không có đăng ký thuê bao, 1 credit = 55,8đ. Tài khoản mới được tặng một ít credit dùng thử để test trước khi nạp thêm. Khi cần nạp, vào tab Billing trong dashboard, chọn gói rồi thanh toán bằng chuyển khoản VietQR qua PayOS. Các gói hiện có:

Xem đầy đủ các gói ở /pricing.html, hoặc đọc hướng dẫn nạp tiền chi tiết từng bước ở bài nạp credit bằng VietQR qua PayOS. Nếu một job (ảnh, video, chat) bị lỗi, credit tương ứng được hoàn lại tự động.

Xử lý khi app không nhận model hoặc báo lỗi key

Vài lỗi hay gặp và cách kiểm tra:

• App báo sai key hoặc 401: kiểm tra lại key đã copy đủ, không dính khoảng trắng; nếu vừa Rotate key thì phải dán lại key mới vào app.
• Không fetch được danh sách model: kiểm tra base URL đã đúng https://taikhoangiare.vn/v1, không thiếu hoặc thừa dấu /.
• Model báo không tồn tại: đối chiếu lại id model với danh sách ở /models.html, một số app yêu cầu nhập id chính xác chữ hoa/thường.
• Vẫn không ra kết quả: test lại bằng lệnh cURL ở Bước 1, nếu cURL cũng lỗi thì vấn đề nằm ở key/credit, không phải ở app chat.

Nếu đã thử các bước trên mà vẫn vướng, có thể liên hệ qua Telegram @taikhoangiare hoặc email support@taikhoangiare.vn.

Dùng thêm cho công việc dòng lệnh và agent

Ngoài app chat, cùng một key này dùng được cho các công cụ dòng lệnh và IDE agent khác trên TaiKhoanGiaRe, ví dụ Claude Code (hướng dẫn cài Claude Code), VS Code Chat (cấu hình VS Code Chat một lệnh), hoặc máy chủ MCP tổng hợp chat/ảnh/video/giọng nói (MCP server TaiKhoanGiaRe). Toàn bộ danh sách hướng dẫn tích hợp theo từng app nằm ở /integrations.html.

Tổng kết

Open WebUI, Cherry Studio và Chatbox đều chỉ cần ba thông tin để chạy với TaiKhoanGiaRe: base URL https://taikhoangiare.vn/v1, API key lấy từ tab API keys trong dashboard, và model id chọn từ /models.html. Test nhanh bằng cURL trước khi cấu hình trong app sẽ giúp bạn tiết kiệm thời gian debug, còn chi phí thì theo dõi trực tiếp trong tab Usage của dashboard theo ngày hoặc theo sản phẩm.

Câu hỏi thường gặp

Open WebUI, Cherry Studio và Chatbox có cần cài thêm plugin để dùng TaiKhoanGiaRe không?

Không, cả ba app đều có sẵn tính năng thêm provider OpenAI-compatible, chỉ cần điền base URL và API key là dùng được.

Có thể dùng cùng một API key cho cả ba app cùng lúc không?

Được, mỗi tài khoản TaiKhoanGiaRe chỉ có một secret key duy nhất và có thể dán key đó vào nhiều app cùng lúc.

Nếu quên API key thì lấy lại ở đâu?

Vào tab API keys trong /dashboard.html và bấm Show để hiện lại key hiện tại; nếu nghi lộ key thì bấm Rotate để tạo key mới, nhưng key cũ sẽ bị vô hiệu hoá ngay.

Chi phí khi chat trong các app này được tính thế nào?

Vẫn tính theo giá token của model đã chọn, như công bố ở /models.html; ví dụ một tin nhắn với claude-sonnet-5 khoảng 29đ, với deepseek-v4-flash khoảng 1,8đ.

← Về trang Blog