Tài liệu

Janitor AI

Cấu hình proxy của Janitor AI yêu cầu URL endpoint đầy đủ, không phải URL cơ sở — đường dẫn phải kết thúc bằng /chat/completions. Điền đúng trường này là xong; các trường còn lại chỉ gồm tên, model id và khóa.

API Settings → Proxy → Add Configuration: Proxy URL là đường dẫn đầy đủ /v1/chat/completions, còn Model Name phải khớp chính xác với catalog id.

Janitor AI · Cài đặt API

☰ → API Settings → Proxy → + Add Configuration

  Config Name   Kunavo
  Model Name    claude-sonnet-5
  Proxy URL     https://api.kunavo.com/v1/chat/completions
  API Key       sk-kn-...

Proxy URL là URL endpoint hoàn chỉnh. Hướng dẫn chính thức của Janitor AI cho biết URL phải kết thúc bằng /chat/completions, vì vậy đây là https://api.kunavo.com/v1/chat/completions — không phải URL cơ sở mà bạn sẽ dán vào công cụ lập trình. Dán URL cơ sở vào đây là nguyên nhân thường gặp nhất khiến “proxy không hoạt động”.

Model Name phải chính xác tuyệt đối. Janitor AI gửi nguyên chuỗi này, vì vậy lỗi chính tả hoặc tên hiển thị sẽ khiến endpoint trả về lỗi thay vì thông báo hữu ích trong giao diện. Sao chép ID từ GET /v1/models hoặc từ /models trên trang này.

Chưa có khóa? Tạo tài khoản Kunavo, tạo khóa (bắt đầu bằng sk-kn-) và nạp tín dụng từ $10 — các lệnh gọi được thanh toán từ số dư đó và các lệnh gọi thất bại không bị tính phí. Sau đó, bảng điều khiển mở tại phần thiết lập Janitor AI.

Từng bước

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.
Mở một cuộc trò chuyện, nhấp vào menu ☰ ở trên cùng rồi chọn Cài đặt API.
Chọn Proxy, sau đó chọn + Thêm cấu hình.
Điền Config Name, Model Name, Proxy URL và API Key chính xác như trên, rồi lưu lại.
Gửi một tin nhắn. Nếu nhận được phản hồi thì proxy hoạt động; lỗi nhắc đến tên mô hình cho biết Model Name có vấn đề, còn lỗi nhắc đến URL cho biết đường dẫn có vấn đề.

Đã kiểm tra đối chiếu với Hướng dẫn proxy chính thức của Janitor AI vào 6 tháng 9, 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 Janitor AI.

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

ID mô hình	Kunavo vào / ra	Phù hợp ở đâu trong Janitor AI
`claude-sonnet-5`	$1.40 / $7.00	lựa chọn mặc định — mức cân bằng mà hầu hết mọi người muốn
`claude-haiku-4-5`	$0.70 / $3.50	rẻ nhất mỗi lượt và nhanh
`claude-opus-5`	$3.50 / $17.50	gói đắt hơn; hãy kiểm tra chi phí mỗi lượt trước khi cam kết
`gpt-5-6-terra`	$0.70 / $4.20	các cuộc trò chuyện dài, khi giới hạn nằm ở kích thước ngữ cảnh

Thanh toán theo token từ số dư trả trước, không có phí hàng tháng — xem trang Thanh toán. Với ngữ cảnh lặp lại — chiếm phần lớn dữ liệu mà trình chỉnh sửa hoặc ứng dụng trò chuyện gửi đi — bộ nhớ đệm prompt ảnh hưởng đến hóa đơn nhiều hơn lựa chọn mô hình.

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

Janitor AI cần Proxy URL nào?

Endpoint chat-completions đầy đủ, không phải URL cơ sở. Hướng dẫn chính thức của Janitor AI nêu rằng URL phải kết thúc bằng /chat/completions và đưa ra đường dẫn hoàn chỉnh làm ví dụ; do đó, với dịch vụ tương thích OpenAI, URL là https://<host>/v1/chat/completions. Nhập URL cơ sở là nguyên nhân thường gặp nhất khiến proxy được cấu hình đúng các mục khác nhưng không trả về gì.

Làm thế nào để thiết lập proxy tùy chỉnh trong Janitor AI?

Mở một cuộc trò chuyện, nhấp menu ☰, chọn API Settings, chọn Proxy rồi nhấp + Add Configuration. Điền Config Name, Model Name chính xác, Proxy URL kết thúc bằng /chat/completions và API Key, sau đó lưu rồi gửi tin nhắn thử. Nếu nhận được phản hồi, cả bốn trường đều đã được xác nhận.

Vì sao Janitor AI báo không tìm thấy mô hình?

Vì Model Name được gửi nguyên văn đến endpoint và phải khớp chính xác với một model id có thật — tên hiển thị, khác biệt về chữ hoa chữ thường và khoảng trắng ở cuối đều khiến yêu cầu thất bại. Hãy sao chép ID từ danh sách mô hình của nhà cung cấp hoặc từ lệnh gọi GET /v1/models, thay vì nhập theo trí nhớ.

Dùng proxy trong Janitor AI có mất phí không?

Chi phí phụ thuộc vào mức phí của endpoint đứng sau proxy. Janitor AI không tính phí sử dụng proxy; nhà cung cấp API tính phí theo token cho mọi tin nhắn được gửi trong cuộc trò chuyện — với một cuộc trò chuyện nhập vai dài, mỗi lượt sẽ bao gồm toàn bộ lịch sử. Chọn mô hình rẻ hơn và endpoint có lưu bộ nhớ đệm prompt sẽ giúp giảm hóa đơn.