TypingMind

Models → Add custom model: Endpoint URL đầy đủ https://api.kunavo.com/v1/chat/completions, header Authorization với Bearer và key của bạn, Model ID cùng context length — mỗi model một mục, được gọi trực tiếp từ trình duyệt.

Models  →  Add custom model  →  Create Manually

Name                    Kunavo · Claude Sonnet 5
Model ID                claude-sonnet-5
Context Length          1000000

Authentication tab
  API Type              OpenAI Chat Completions API
  Endpoint URL          https://api.kunavo.com/v1/chat/completions
  Authentication Type   API Key via HTTP Header
    Header Key          Authorization
    Header Value        Bearer sk-kn-...

Capabilities tab        tick only what you have checked (see below)
Request Options tab     leave "Route requests via TypingMind Cloud" off

                        → Test & Save

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. Trong TypingMind, mở Models ở thanh bên trái và nhấp Add custom model. Giữ nguyên Create Manually; Import JSON và Import OpenRouter dành cho các nguồn khác.
3. Điền Name (tùy ý), Model ID (đúng như danh sách GET /v1/models — ví dụ claude-sonnet-5) và Context Length. Biểu mẫu điền sẵn 128000; hãy đặt cửa sổ ngữ cảnh thực của model theo trang model, vì TypingMind dùng con số này để quyết định lượng lịch sử sẽ gửi.
4. Trên thẻ Xác thực, chọn Loại API = OpenAI Chat Completions API, dán đầy đủ URL điểm cuối, đặt Loại xác thực thành API Key via HTTP Header, rồi nhập Khóa tiêu đề Authorization cùng Giá trị tiêu đề Bearer sk-kn-... — từ Bearer, một dấu cách, rồi đến khóa.
5. Trong Khả năng, hãy đánh dấu các tính năng theo cách thủ công hoặc bật Tự động kiểm tra khả năng khi lưu — biểu mẫu cho biết sẽ gửi “một vài yêu cầu thử nghiệm” khi lưu, việc này tính phí một ít token. Bạn có thể điền Định giá với mức giá trên mỗi triệu token trong bảng bên dưới để phần hiển thị chi phí của TypingMind khớp với hóa đơn. Sau đó nhấp Kiểm tra & Lưu.
6. Lặp lại cho từng model. Không có mục cấp nhà cung cấp cho điểm cuối tùy chỉnh: Claude Sonnet, Claude Haiku và một model GPT là ba model tùy chỉnh riêng biệt có cùng URL điểm cuối và tiêu đề.

Đã kiểm tra đối chiếu với Tài liệu về model của TypingMind 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 TypingMind.

# 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.

Ba loại API còn lại

Danh sách thả xuống API Type trên biểu mẫu hiện tại có OpenAI Chat Completions API, OpenAI Responses API, Claude Messages API và Gemini API. Kunavo hỗ trợ ba loại đầu; mỗi loại cần có đường dẫn đầy đủ riêng trong Endpoint URL.

• Claude Messages API — URL điểm cuối https://api.kunavo.com/v1/messages. Ví dụ định dạng Claude của TypingMind dùng tiêu đề x-api-key; trên đường dẫn này, Kunavo chấp nhận cả tiêu đề đó lẫn Authorization: Bearer. Kunavo chỉ phục vụ các ID thuộc dòng Claude trên đường dẫn này.
• OpenAI Responses API — URL điểm cuối https://api.kunavo.com/v1/responses, cùng tiêu đề Bearer. Tài liệu của TypingMind không có ví dụ hoàn chỉnh cho loại này, nên dạng đường dẫn đầy đủ được suy ra từ ba loại còn lại, chứ không phải trích dẫn.
• Gemini API — không dùng cho điểm cuối này. API này yêu cầu định dạng yêu cầu gốc của Google; hãy gọi các model Gemini qua loại Chat Completions.

Đây không phải TypingMind API

“TypingMind API” thường chỉ REST API của một phiên bản TypingMind Teams (custom.typingmind.com), dùng để quản lý phiên trò chuyện đó. API này không bán token model và không liên quan đến cấu hình này. Model tùy chỉnh chỉ đơn giản là TypingMind gọi điểm cuối của bên khác bằng khóa do bạn cung cấp.

Hai khoản phí riêng biệt

Giấy phép TypingMind là phí sử dụng ứng dụng. Mỗi tin nhắn bạn gửi qua model tùy chỉnh được tính phí theo token bởi bên sở hữu khóa trong tiêu đề — ở đây là Kunavo, trừ vào số dư trả trước. Các gói giấy phép và chi phí cho một tháng trò chuyện theo mức giá này được trình bày trong Định giá TypingMind và chi phí API.

Khi Kiểm tra & Lưu thất bại

• 404 với “POST /v1 là URL cơ sở, không phải điểm cuối” (hoặc “Not found: /” khi URL chỉ dừng ở tên máy chủ) — URL điểm cuối bị thiếu đường dẫn. URL phải kết thúc bằng /v1/chat/completions (hoặc /v1/messages, /v1/responses đối với các loại đó). Trước ngày 1 tháng 10 năm 2026, cả hai trường hợp đều trả về trang HTML.
• 404 với “Không tìm thấy điểm cuối này” — đường dẫn bị viết sai, chẳng hạn /v1/chat/completion. Cùng thông báo đó cũng nêu đường dẫn gần nhất mà Kunavo hỗ trợ.
• 404 với “Not found: /chat/completions. Kunavo's API lives under /v1” — đường dẫn tồn tại nhưng thiếu /v1: URL điểm cuối là https://api.kunavo.com/chat/completions. Thêm /v1 trước đường dẫn. (Đã kiểm tra ngày 1 tháng 10 năm 2026; trước ngày đó, cùng lỗi này trả về trang HTML.)
• 401 “Thiếu hoặc không hợp lệ API key” — tiêu đề không đúng: Khóa tiêu đề phải là Authorization và giá trị phải bắt đầu bằng Bearer , hoặc khóa đã bị thu hồi.
• Lỗi model không khả dụng — Model ID không được viết đúng như trong danh sách GET /v1/models. ID viết thường và nối bằng dấu gạch ngang.
• Lỗi mạng hoặc CORS trong bảng điều khiển của trình duyệt — hãy kiểm tra URL điểm cuối là https://api.kunavo.com, không phải tên miền trang web; máy chủ API mới là nơi gửi tiêu đề CORS.