Kết nối Cherry Studio với CheapTokens: nhà cung cấp tùy chỉnh, Base URL

Để dùng CheapTokens trong Cherry Studio, hãy thêm một nhà cung cấp tùy chỉnh (Settings → Model Provider → Add Provider), đặt https://api.cheaptokens.dev/v1/ vào trường OpenAI Base URL, dán API key của bạn và thêm thủ công model id deepseek-ai/DeepSeek-V4-Flash-0731. Sau đó kiểm tra key bằng Model Check và gửi lời chào. Chỉ có vậy thôi; chi tiết duy nhất dễ khiến bạn vấp là dấu gạch chéo ở cuối URL.

Bạn mở một ứng dụng chat trên desktop vì bạn muốn một cửa sổ cho nhiều model và một số dư chung phía sau chúng, chứ không phải một tab trình duyệt cho mỗi dịch vụ. Cherry Studio được xây dựng cho đúng việc đó: đây là một AI workstation mã nguồn mở cho Windows, macOS và Linux (AGPL-3.0 Community Edition) với chat, agent và knowledge base, và nó chấp nhận bất kỳ dịch vụ tương thích OpenAI nào làm nhà cung cấp tùy chỉnh. CheapTokens nói định dạng OpenAI Chat Completions, nên nó phù hợp. Các bước dưới đây theo trang tài liệu của Cherry Studio về nhà cung cấp tùy chỉnh, đã kiểm tra ngày 7 tháng 11 năm 2026; bản thân ứng dụng thay đổi, nên nếu một nhãn đã chuyển chỗ, hãy tìm từ tương tự ở gần đó.

Những gì bạn cần trước khi mở ứng dụng#

Ba thứ, đều ngắn gọn:

• Base URL: https://api.cheaptokens.dev/v1/ (có dấu gạch chéo ở cuối — lý do ở phần tiếp theo);
• một API key từ tài khoản CheapTokens của bạn, giữ ở nơi bạn có thể sao chép, không dán vào một ghi chú chia sẻ;
• model id đầy đủ. Tên ngắn từ bảng giá không được API chấp nhận; hãy dùng id của gateway, ví dụ deepseek-ai/DeepSeek-V4-Flash-0731. Các id khác có trong hướng dẫn list-models và trong tài liệu CheapTokens.

Thêm nhà cung cấp tùy chỉnh#

Mở Settings (biểu tượng bánh răng), rồi Model Provider. Ở cuối danh sách nhà cung cấp là + Add Provider. Nhấp vào đó và hộp thoại Add Custom Provider hiện ra.

Điền như sau:

Cherry Studio hiển thị mặc định các trường endpoint 'OpenAI' và 'Anthropic'. Chỉ điền giao thức bạn thực sự dùng; với chat thông thường đó là trường OpenAI, và trường Anthropic có thể để trống. Dưới mỗi trường Base URL, ứng dụng hiển thị bản xem trước đường dẫn yêu cầu cuối cùng. Hãy đọc nó. Đó là cách nhanh nhất để phát hiện địa chỉ sai trước khi gửi bất cứ thứ gì.

Nhấp Add để lưu.

Vì sao dấu gạch chéo ở cuối lại quan trọng#

Cherry Studio xây dựng URL yêu cầu từ Base URL của bạn theo ba quy tắc trong tài liệu của nó (đã kiểm tra ngày 7 tháng 11 năm 2026):

• một địa chỉ gốc như https://example.com sẽ được nối thêm /v1/chat/completions;
• một địa chỉ kết thúc bằng / chỉ được nối thêm chat/completions;
• một địa chỉ kết thúc bằng # được dùng đúng như đã nhập, không thêm gì.

CheapTokens nằm dưới /v1, nên https://api.cheaptokens.dev/v1/ là dạng biến thành https://api.cheaptokens.dev/v1/chat/completions — đường dẫn mà API mong đợi. Bản xem trước dưới trường phải đọc đúng như vậy. Nếu bạn thấy /v1/v1/ hoặc hoàn toàn không có /v1, hãy sửa trường trước khi tiếp tục.

Key, model và Model Check#

Quay lại trang của nhà cung cấp, có năm bước nhỏ. Hãy làm theo thứ tự này:

Một lưu ý về bước 5. Trang cũng có nút Sync models để lấy danh sách model từ dịch vụ. Cách đáng tin cậy là tự thêm id bằng +: nhập chính xác deepseek-ai/DeepSeek-V4-Flash-0731, bao gồm phần deepseek-ai/. Các model bạn có thể thêm:

Model Check là nút bên cạnh trường key; theo tài liệu Cherry Studio, nó kiểm tra key có hợp lệ không. Nếu nó báo lỗi, hãy nhảy đến phần lỗi bên dưới: nguyên nhân thường là một trong ba trường.

Gửi tin nhắn đầu tiên#

Mở một cuộc chat mới, chọn nhà cung cấp CheapTokens và model bạn đã thêm trong bộ chọn model ở trên cùng, rồi viết gì đó ngắn, như 'Giải thích token là gì trong hai câu.' Một câu trả lời từ model nghĩa là toàn bộ chuỗi hoạt động: key, địa chỉ, model id.

Muốn xem một yêu cầu mà không cần ứng dụng? Đây là một lệnh gọi Chat Completions thuần:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-ai/DeepSeek-V4-Flash-0731", "messages": [{"role": "user", "content": "Explain what a token is in two sentences."}]}'

Phản hồi là JSON với văn bản trong choices[0].message.content và số lượng token trong usage.

Nên đặt model nào vào chat desktop#

Một cửa sổ chat là công việc khác với vòng lặp agent: bạn hỏi, đọc, hỏi lại. Khi đó hai điều quan trọng: câu trả lời có thể dài bao nhiêu và một cuộc hội thoại vừa được bao nhiêu.

• DeepSeek-V4-Flash — lựa chọn mặc định cho chat chung và tài liệu dài: tối đa 32,768 token đầu ra mỗi câu trả lời, context 380K, một mức giá ở mọi thời điểm. Tính tổng, với input và output cộng lại, nó rẻ hơn OpenRouter.
• GLM-5.3-Flash — chat hàng ngày với cửa sổ lớn nhất trong ba model (390K), rẻ hơn OpenRouter ở cả input và output.
• MiniMax-M2.7 — chat và các tác vụ kiểu agent với context 180K, rẻ hơn OpenRouter ở cả hai phía.

Cả ba đều nằm sau một số dư, nên bạn có thể thêm cả ba id vào cùng một nhà cung cấp và chuyển đổi trong bộ chọn model mà không cần chạm vào key.

Một phiên chat tốn bao nhiêu#

Đây là một hình dung sơ bộ. Giả sử bạn có một cuộc hội thoại 20 tin nhắn. Mỗi tin nhắn gửi lại lịch sử trước đó, nên một yêu cầu trung bình khoảng 6,000 token vào và 500 token ra (lý do được đề cập trong vì sao một cuộc chat dài tốn hơn). Một yêu cầu trên DeepSeek-V4-Flash tốn $0.00014. Hai mươi yêu cầu như vậy có trong máy tính bên dưới; hãy kéo các thanh trượt cho khớp với các cuộc chat của bạn.

Bảng dưới đây chạy cùng phiên đó trên tất cả các model, với một cột OpenRouter để so sánh:

Để xem giá hiện tại trên 1M token, hãy xem bảng giá CheapTokens.

Nếu nó không hoạt động#

Hầu hết vấn đề đến từ cùng ba trường: key, URL, model id. Hãy đối chiếu những gì bạn thấy với nguyên nhân:

Để có hướng dẫn dài hơn về các lỗi này, hãy xem API 401 hoặc 404: sai key, base URL hoặc model id. Và nếu bạn thích chat trên trình duyệt hơn là ứng dụng desktop, Open WebUI hoạt động theo cùng cách.

Nguồn: tài liệu Cherry Studio, các trang về nhà cung cấp tùy chỉnh và cài đặt nhà cung cấp, đã kiểm tra ngày 7 tháng 11 năm 2026; dự án ở github.com/CherryHQ/cherry-studio.