Kết nối DeepSeek Harness với CheapTokens: nhà cung cấp tùy chỉnh

Để dùng DeepSeek Harness với CheapTokens, mở Settings → Models, chuyển thẻ sang Custom model API, đặt base URL thành https://api.cheaptokens.dev/v1, chọn OpenAI Chat Completions làm giao thức, dán key CheapTokens của bạn và thêm model id deepseek-ai/DeepSeek-V4-Flash-0731. Chọn model đó trong trình chọn và phiên tiếp theo của bạn sẽ chạy trên nó.

Đó là toàn bộ mẹo. Phần còn lại của trang này là biểu mẫu chính xác, một bước kiểm tra nhanh rằng key hoạt động trước khi bạn đổ lỗi cho ứng dụng, và một danh sách ngắn những gì cần xem khi gateway từ chối.

Các cài đặt bên dưới lấy từ tài liệu Harness tính đến ngày 24 tháng 10 năm 2026. Dự án đang trong giai đoạn xem trước công khai, và README của nó cảnh báo rằng sẽ có những thay đổi phá vỡ tương thích, nên nếu một nhãn đã di chuyển, hãy tin vào màn hình và hướng dẫn nhà cung cấp.

Bạn đang kết nối cái gì#

DeepSeek Harness là một agent mã nguồn mở của DeepSeek (giấy phép MIT, xây dựng trên kiến trúc plugin Cordis). Nó có dạng ứng dụng desktop cho macOS trên Apple silicon và Windows 64-bit, hoặc dạng web UI bạn khởi động bằng npx @deepseek-ai/dsh web (cần Node.js). Web UI mở tại http://127.0.0.1:3080 theo mặc định.

Mặc định nó yêu cầu key DeepSeek. Nhưng cùng màn hình Models đó có một thẻ cho bất cứ thứ gì không nằm trong danh mục của nó, một relay, một gateway của công ty hoặc một nhà cung cấp khác. Thẻ đó là thứ chúng ta dùng.

Về phía CheapTokens bạn cần hai thứ: một key và một số dư. Nếu bạn chưa tạo key, Yêu cầu API đầu tiên của bạn với CheapTokens mất vài phút, và API key là gì và cách lưu trữ an toàn nói về nơi giữ nó.

Kiểm tra key trước khi bạn mở Harness#

Một yêu cầu từ terminal cho bạn biết liệu key, số dư và model id có ổn không. Nếu cái này chạy được mà Harness thì không, vấn đề nằm ở biểu mẫu, không phải ở tài khoản.

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": "Say hi in five words."}]
  }'

Bạn sẽ nhận được một câu trả lời JSON với một mảng choices và một khối usage đếm token đầu vào và đầu ra. Lỗi kiểu Invalid API key nghĩa là key; thông báo về số dư nghĩa là cần nạp thêm.

Điền vào biểu mẫu nhà cung cấp tùy chỉnh#

Mở Settings → Models và chuyển thẻ nhà cung cấp sang Custom model API. Điền các trường như sau:

Hai chi tiết khiến người ta vấp. Thứ nhất, base URL là https://api.cheaptokens.dev/v1, đúng như trong curl ở trên trừ /chat/completions. Thứ hai, model id là cái đầy đủ với tiền tố deepseek-ai/. Một tên ngắn như deepseek-v4-flash không phải là thứ API mong đợi. Nếu bạn muốn hiểu nền tảng về base_url và cách chuyển nó, xem API tương thích OpenAI: base_url là gì và cách chuyển.

Còn có một nút Fetch available models. Tài liệu nói nó truy vấn GET /models và rằng bạn luôn có thể gõ id bằng tay. Gõ bằng tay là đường an toàn ở đây, nên hãy làm vậy.

Chọn model và chạy tác vụ đầu tiên#

Mở trình chọn model và chọn model CheapTokens. Chọn một model ở đó khiến nó thành mặc định cho các phiên mới, nên bạn không phải lặp lại.

Giờ hãy giao cho nó một việc nhỏ và có thể kiểm tra. Giả sử bạn có một dự án với một test đang lỗi:

Run the tests, find why test_parse_date fails and fix it. Show me the diff.

Điều bạn muốn thấy: agent chạy lệnh test, đọc file lỗi, sửa nó, chạy lại test và hiển thị diff. Nếu nó làm được vậy, kết nối đã xong. Số dư của bạn giờ là thứ chi trả cho vòng lặp.

Vì sao một model rẻ phù hợp với vòng lặp agent#

Một agent không gửi một câu hỏi. Nó gửi lại toàn bộ cuộc hội thoại, danh sách file và đầu ra công cụ ở mỗi bước, nên một phiên chủ yếu là token đầu vào. Đó là điều khiến hóa đơn agent gây bất ngờ (vì sao một cuộc trò chuyện dài tốn hơn giải thích cơ chế, và Cách ước tính chi phí của một AI agent đưa ra phương pháp).

Giả sử một phiên có 200 bước, mỗi bước gửi khoảng 30.000 token ngữ cảnh và nhận lại khoảng 600 token. Đó là 200 × 30.000 = 6.000.000 token đầu vào và 200 × 600 = 120.000 token đầu ra. Trên DeepSeek-V4-Flash phiên đó tốn $0.102 theo giá hôm nay, và rẻ hơn OpenRouter về tổng thể, khi tính cả đầu vào lẫn đầu ra. Bảng bên dưới dùng cùng khối lượng công việc cho mọi model chúng tôi cung cấp:

Với các phiên dài, DeepSeek-V4-Flash cho bạn cửa sổ ngữ cảnh 380K, tối đa 32.768 token trong một câu trả lời, và một mức giá bất kể giờ nào: không phụ thu giờ cao điểm. Nó dùng cùng số dư như mọi model CheapTokens khác, nên bạn có thể chuyển model trong Harness mà không cần nạp thêm. Giá hiện tại nằm trên trang giá, và trang model có thêm về dòng DeepSeek.

Muốn giữ phiên nhẹ hơn? Thêm zai-org/GLM-5.3-Flash (ngữ cảnh 390K, tối đa 8.192 token đầu ra) hoặc MiniMaxAI/MiniMax-M2.7 (ngữ cảnh 180K, tối đa 8.192 token đầu ra) vào cùng nhà cung cấp như các model id bổ sung. Một nhà cung cấp có thể chứa nhiều model, và trình chọn cho phép bạn di chuyển giữa chúng.

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

Tài liệu Harness liệt kê những nghi phạm thường gặp. Đây là chúng cùng với việc cần làm:

• Gateway từ chối mọi yêu cầu dù key và URL đúng. Hình dạng yêu cầu khác với thứ endpoint mong đợi. Harness có các cài đặt tương thích theo từng model, như role dùng cho system prompt hay tên của trường output-token. Chúng nằm trong $DSH_HOME/profiles/<profile>/cordis.patch.yml và tải lại mà không cần khởi động lại. Hãy lấy các key chính xác từ hướng dẫn nhà cung cấp thay vì đoán.
• Menu effort biến mất với model bạn đã gõ vào. Harness chỉ hiển thị các mức suy luận cho những model khai báo chúng. Một model nhập tay không khai báo gì, nên menu vẫn trống. Khai báo các mức là một phần của cùng file cài đặt theo từng model.
• 401 khi fetch models. Kiểm tra key, hoặc bỏ qua nút và tự nhập model id.
• Câu trả lời dừng giữa câu. Đó là giới hạn token, không phải kết nối hỏng; xem vì sao câu trả lời AI dừng giữa câu.
• 401 hoặc 403 trong log từ yêu cầu đầu tiên. Lặp lại bước kiểm tra curl ở trên với cùng key. Nếu curl chạy được, gõ lại key trong trường Credential; một dấu cách thừa ở cuối là lỗi kinh điển.

Nếu bạn đã dùng một agent khác với cùng key, kết nối OpenCode theo cùng khuôn mẫu, và tài liệu CheapTokens liệt kê mọi endpoint. Thêm một công cụ nữa trong cùng ngăn kéo, một số dư.

Trước khi bạn đóng tab#

• Base URL: https://api.cheaptokens.dev/v1
• Protocol: OpenAI Chat Completions
• Model id: deepseek-ai/DeepSeek-V4-Flash-0731
• Key: từ tài khoản CheapTokens của bạn, giữ ngoài ảnh chụp màn hình và repo

Chạy tác vụ test lỗi một lần và xem mức sử dụng trên số dư của bạn. Lần chạy đó cho bạn biết các phiên của chính bạn tốn bao nhiêu.