DeepSeek Harness

Settings → Models → “Add model provider” → “Custom model API” nhận năm trường — Provider ID, display name, base URL, API protocol và API key — đưa Claude và GPT vào cùng bộ chọn với thẻ DeepSeek tích hợp.

# Settings → Models → Add model provider → Custom model API
#
#   Provider ID     kunavo          (lowercase, and permanent)
#   display name    Kunavo
#   base URL        https://api.kunavo.com/v1
#   API protocol    OpenAI Chat Completions   (openai-completions)
#   API key         sk-kn-...
#
# Then Model catalog → Fetch available models → Add selected,
# or type the ids by hand. The page writes the active profile's
# $DSH_HOME/profiles/<profile>/cordis.patch.yml — profile "web" under
# `dsh web`. The same provider there, plus an optional second one
# that sends Claude ids over Anthropic Messages, whose base URL has
# NO /v1. This entry replaces the whole llm-pi-ai config: keep any
# provider already in it.

- id: llm-pi-ai
  config:
    providers:
      kunavo:
        apiKeyEnv: KUNAVO_API_KEY
        api: openai-completions
        baseURL: https://api.kunavo.com/v1   # → /v1/chat/completions
        models:
          - id: claude-sonnet-5
          - id: claude-opus-5
          - id: claude-haiku-4-5
          - id: gpt-5-6-sol
      kunavo-claude:
        apiKeyEnv: KUNAVO_API_KEY
        api: anthropic-messages
        baseURL: https://api.kunavo.com      # → /v1/messages
        models:
          - id: claude-sonnet-5
          - id: claude-haiku-4-5

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
2. Khởi động giao diện web (dsh web) và đi đến Cài đặt → Mô hình. Chọn Thêm nhà cung cấp mô hình. Thẻ mở ở mục Nhà cung cấp mô hình bên thứ ba, chỉ liệt kê các nhà cung cấp đi kèm dsh — chuyển sang API mô hình tùy chỉnh.
3. Điền ID nhà cung cấp (chữ thường và cố định — tài liệu cho biết các yêu cầu, phiên đã lưu, giá trị mặc định của mô hình và tham chiếu thông tin xác thực đều sử dụng ID này; đổi tên đồng nghĩa với việc thêm nhà cung cấp mới và xóa nhà cung cấp cũ), tên hiển thị, URL cơ sở https://api.kunavo.com/v1, giao thức API OpenAI Chat Completions và khóa API. Khóa chỉ cho phép ghi; dsh giữ khóa trong $DSH_HOME/.credentials.yaml và chỉ lưu tham chiếu đến khóa trong hồ sơ.
4. Trong Danh mục mô hình, chọn Lấy các mô hình khả dụng — Kunavo phản hồi GET /v1/models, nên bộ chọn sẽ tự điền danh sách. Đánh dấu các mô hình bạn muốn và chọn Thêm các mục đã chọn. Các id nhập thủ công hoạt động giống hệt, và tài liệu hướng dẫn dùng cách đó bất cứ khi nào tính năng khám phá không liệt kê được mô hình nào.
5. Tùy chọn: với các id Claude qua giao thức riêng của Anthropic, thêm API mô hình tùy chỉnh thứ hai có ID nhà cung cấp riêng, URL cơ sở https://api.kunavo.com — không có /v1 — giao thức API Anthropic Messages và cùng khóa đó. Chức năng lấy danh sách ở đây cũng liệt kê toàn bộ danh mục; chỉ thêm các id claude- (vì sao chỉ những id đó).
6. Chọn một mô hình trong ô soạn thảo và gửi một lượt yêu cầu thao tác với tệp, thay vì lời chào — harness dựa vào việc gọi công cụ cho phần lớn hoạt động, nên lần chạy đầu tiên đọc và chỉnh sửa nội dung sẽ cho bạn biết nhiều hơn. Thay đổi mô hình có hiệu lực từ yêu cầu tiếp theo; tài liệu nêu rõ rằng không cần khởi động lại bất cứ thứ gì.

Đã kiểm tra đối chiếu với trang “Cấu hình mô hình” của DeepSeek Harness (cùng nội dung với docs/user/guide/providers.md tại thẻ dsh-v0.2.0-rc.2) vào 1 tháng 10, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong DeepSeek Harness.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.

Claude qua Anthropic Messages

Kunavo cũng xử lý API Anthropic Messages, và anthropic-messages là một trong ba giao thức mà biểu mẫu cung cấp. Tài liệu của harness nêu rõ rằng “Một nhà cung cấp sử dụng một giao thức, nên cổng API cung cấp hai giao thức cần hai nhà cung cấp” — vì vậy đây là nhà cung cấp thứ hai bên cạnh nhà cung cấp thứ nhất, không phải một thiết lập của nhà cung cấp thứ nhất.

• URL cơ sở https://api.kunavo.com, địa chỉ gốc không kèm đường dẫn. Trong lần chạy, địa chỉ gốc đó gửi POST đến /v1/messages?beta=true — đường dẫn mà Claude Code cũng dùng và Kunavo xử lý. Khi có /v1 ở cuối, yêu cầu POST được gửi đến /v1/v1/messages. DeepSeek Harness so với Claude Code đặt yêu cầu của hai ứng dụng khách cạnh nhau để đối chiếu.
• Chỉ các id Claude. /v1/messages của Kunavo chỉ phục vụ các id claude-; một id gpt- tại đó sẽ nhận 404 có nêu /v1/chat/completions. Giữ GPT trên nhà cung cấp openai-completions.
• Chức năng lấy danh sách liệt kê mọi mô hình; chỉ thêm các mô hình Claude. README llm-pi-ai của dsh cho biết tính năng khám phá trên giao thức này truy vấn GET /v1/models với header x-api-key của Anthropic, và danh sách mô hình của Kunavo nhận khóa trong header đó giống như trong Authorization: Bearer — thông tin này đến từ mã nguồn dsh và các bài kiểm tra của chính Kunavo, không phải từ lần chạy. Những gì Lấy các mô hình khả dụng nhận về là toàn bộ danh mục, bao gồm GPT và các mô hình hình ảnh, nên chỉ đánh dấu các id claude-; nhập thủ công cũng hoạt động như vậy. Danh sách đầy đủ chứng minh ít hơn vẻ bề ngoài: cùng README đó cho biết URL liệt kê được chấp nhận dù có hay không có /v1, trong khi yêu cầu mô hình dùng nguyên URL cơ sở — vì vậy chức năng lấy danh sách cũng điền được danh sách từ https://api.kunavo.com/v1, còn lượt đầu tiên từ URL cơ sở đó đi đến /v1/v1/messages.
• Lợi ích bạn nhận được. Yêu cầu đến theo định dạng của Anthropic — trong lần chạy, lời nhắc hệ thống được truyền trong trường system ở cấp cao nhất, nên vai trò developer không xuất hiện — và Kunavo chuyển tiếp nguyên trạng thay vì chuyển đổi từ định dạng OpenAI. Nhà cung cấp openai-completions truy cập cùng các id Claude qua bước chuyển đổi, đó là lý do nhà cung cấp này được dùng trong các bước hướng dẫn.

Tệp đứng sau biểu mẫu

Trang Mô hình ghi vào $DSH_HOME/profiles/<profile>/cordis.patch.yml — $DSH_HOME/profiles/web/cordis.patch.yml khi bạn khởi động bằng dsh web. Các tài liệu dsh cũ chỉ đến $DSH_HOME/settings.yaml; tài liệu của 0.2.0-rc.2 thì không. Khi trình duyệt ở cùng máy với máy chủ, Mở tệp cấu hình trong phần đầu trang Cài đặt sẽ mở tệp đó, và các bộ điều hợp đọc lại tệp ở yêu cầu tiếp theo. Có năm điều quan trọng với endpoint này:

1. Cửa sổ ngữ cảnh và số token đầu ra tối đa — trong biểu mẫu, dưới Thiết lập tùy chỉnh → Tùy chọn mô hình. Một id nhập thủ công không mang theo cả hai thông số này, nên các giá trị dự phòng của luồng được áp dụng: 262.144 token ngữ cảnh và 32.768 token đầu ra, theo README llm-pi-ai — và trong lần chạy, cả hai nhà cung cấp tùy chỉnh đều yêu cầu chính xác max_tokens: 32768. Mọi id trong bảng bên trên đều hỗ trợ nhiều hơn; dù dùng cách nào, hãy kiểm tra dòng tương ứng và tăng các giá trị theo mục trong danh mục của mô hình nếu bạn muốn nhiều hơn. Kunavo tính phí theo số token mô hình viết ra, không phải giới hạn.
2. compat.supportsDeveloperRole — không cần thiết. Harness khuyến nghị tùy chọn này cho các cổng API từ chối vai trò developer; Kunavo đọc vai trò đó như lượt hệ thống trên mọi họ mô hình, bao gồm Claude. (Cho đến 2026-09-30, luồng xử lý Claude đã loại bỏ vai trò này, và mục này từng hướng dẫn bạn bật tùy chọn — giữ tùy chọn ở trạng thái bật không gây hại.)
3. compat.maxTokensField — giữ nguyên. Harness kết hợp tùy chọn này với tùy chọn bên trên như cách khắc phục đầu tiên thường dùng, nhưng bộ xử lý của chính Kunavo đọc max_completion_tokens và dùng max_tokens làm giá trị dự phòng, nên giá trị mặc định đã hoạt động.
4. reasoningEfforts — không có trường trong biểu mẫu. Mô hình bạn nhập thủ công không khai báo mức nào, nên menu Mức độ suy luận không xuất hiện và giá trị mặc định của endpoint quyết định mô hình có suy luận hay không. Tự khai báo các mức nếu bạn muốn có menu; trên openai-completions, mỗi khóa là một mức và giá trị của khóa là cách viết được gửi dưới dạng reasoning_effort. Giá trị đó được chuyển đến id gpt-; với id claude-, nó không có tác dụng vì giao diện chat của Kunavo không chuyển tiếp reasoning_effort đến Anthropic (/docs/chat#reasoning).
5. Loại đầu vào (input: [text, image] trong tệp) — tài liệu nêu rõ rằng thiết lập này “đưa ra một tuyên bố về endpoint của bạn thay vì kiểm tra nó”. Việc đánh dấu Hình ảnh cho một id không nhận hình ảnh không bị harness phát hiện; yêu cầu sẽ bị từ chối ở bước xử lý phía sau. Kiểm tra id trên /models trước khi đánh dấu ô.

Phần còn lại mà một phiên gửi — 24 định nghĩa công cụ mỗi lượt, một yêu cầu tiêu đề ngắn cho mỗi phiên mới và các trường bổ sung trên luồng riêng của DeepSeek — được đo lường tại Chi phí DeepSeek Harness.