Cấu hình proxy Janitor AI: định dạng URL, model và cách sửa lỗi 429

Trả lời nhanh: ba trường JanitorAI yêu cầu

Cấu hình proxy của JanitorAI cần đúng ba giá trị: một proxy URL, một tên model, và một API key. Proxy URL phải là endpoint chat completions đầy đủ, không phải một base URL. Nếu provider của bạn đưa cho bạn một base URL kết thúc ở /v1, hãy thêm /chat/completions vào trước khi dán nó vào JanitorAI. Chỉ riêng chi tiết này gây ra nhiều lỗi cấu hình hơn tất cả mọi thứ khác cộng lại. Nhập model ID chính xác như provider viết, bao gồm chữ thường và dấu gạch ngang, rồi lưu và gửi một tin nhắn test ngắn. Nếu có phản hồi quay lại, bạn đã xong. Nếu bạn nhận được mã lỗi thay vào đó, hãy nhảy đến bảng lỗi bên dưới. Mỗi mã lỗi phổ biến đều có một nguyên nhân cụ thể và một cách sửa cụ thể.

Proxy URL:  https://api.apisrouter.com/v1/chat/completions
Model:      deepseek-v4-flash
API Key:    sk-...   (dán chính xác, không có dấu ngoặc kép, không khoảng trắng cuối)

Ý nghĩa của "proxy" trong cộng đồng JanitorAI

Từ này gây hiểu lầm. Trong tiếng lóng JanitorAI, một proxy không phải là một proxy mạng hay một VPN. Đó là bất kỳ endpoint API tương thích OpenAI nào mà trang web gửi các request chat của bạn đến thay vì backend mặc định của nó. Cộng đồng đã áp dụng thuật ngữ này từ nhiều năm trước khi mọi người bắt đầu định tuyến chat qua các reverse proxy của API provider, và cái tên đó vẫn giữ nguyên dù hầu hết cấu hình ngày nay nói chuyện trực tiếp với một provider hoặc gateway. Mọi người chạy một proxy vì ba lý do. Thứ nhất, lựa chọn model: bạn chọn chính xác LLM nào viết nhân vật của mình thay vì chấp nhận bất cứ thứ gì trang web đặt mặc định. Thứ hai, chất lượng: các model như DeepSeek V4 hay Claude viết các cảnh dài hơn, mạch lạc hơn so với tier tích hợp sẵn miễn phí. Thứ ba, kiểm soát chi phí: với một key trả theo token bạn thấy chính xác mỗi chat tốn bao nhiêu thay vì trả cho một subscription mà bạn có thể không dùng hết. Có ba loại endpoint bạn sẽ thấy được chia sẻ trong cộng đồng. API provider chính thức (OpenAI, Anthropic, xAI, DeepSeek) yêu cầu một tài khoản với mỗi vendor. Gateway tổng hợp nhiều model đằng sau một URL tương thích OpenAI và một key duy nhất. "Proxy miễn phí" của cộng đồng là các key dùng chung do người khác trả tiền, đó là lý do chúng không ổn định và bị rate limit nặng. Một điều nữa đáng nói thẳng: dù bạn dùng endpoint nào, chính sách nội dung của provider model upstream vẫn áp dụng cho mọi phản hồi, và điều khoản riêng của JanitorAI, bao gồm yêu cầu chỉ dành cho người lớn, vẫn chi phối nền tảng. Biết cả hai chính sách trước khi chọn một model giúp bạn tránh bị từ chối giữa cảnh.

Cấu hình đầy đủ: từ API key đến phản hồi đầu tiên

Nếu bạn muốn một key bao phủ DeepSeek, GLM, Kimi, Claude, Gemini và Grok cùng lúc, một gateway tương thích OpenAI như APIsRouter là hướng đi ít ma sát nhất: checkout tại /topup không yêu cầu đăng ký tài khoản, key gửi đến qua email, và proxy URL cho JanitorAI là https://api.apisrouter.com/v1/chat/completions. Một điểm tinh tế nếu bạn cũng dùng SillyTavern: SillyTavern muốn base URL kết thúc ở /v1 và tự động điền danh sách model của nó từ /v1/models với key của bạn, trong khi JanitorAI muốn path đầy đủ bao gồm /chat/completions. Cùng một endpoint, khác lượng URL. Nhầm lẫn hai định dạng này là nguyên nhân hàng đầu gây lỗi 404 ở cả hai app.

• Lấy một API key từ một provider hoặc gateway tương thích OpenAI. Bạn cần chuỗi key và URL endpoint đã được tài liệu hóa.
• Mở bất kỳ chat nhân vật nào trên JanitorAI, rồi mở API Settings và chọn tùy chọn Proxy.
• Dán URL endpoint đầy đủ kết thúc bằng /chat/completions vào trường proxy URL.
• Gõ model ID chính xác như đã được tài liệu hóa, ví dụ deepseek-v4-flash hoặc glm-5.
• Dán API key, lưu cài đặt, và refresh trang nếu việc lưu không được ghi nhận.
• Gửi một tin nhắn test một dòng. Một phản hồi bình thường nghĩa là toàn bộ chuỗi hoạt động.

Test endpoint bằng curl trước khi đổ lỗi cho JanitorAI

Khi một proxy hoạt động sai, hãy test endpoint bên ngoài JanitorAI trước. Một lệnh curl 10 giây sẽ cho bạn biết vấn đề nằm ở endpoint, key, hay cách bạn cấu hình trang web. Chạy lệnh này trong bất kỳ terminal nào, với key và model của riêng bạn:

curl https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Reply with one short sentence."}]
  }'

Lỗi 429: vì sao proxy miễn phí rate-limit vào giờ cao điểm

Một phản hồi 429 nghĩa là "quá nhiều request". Đây là lỗi proxy được báo cáo nhiều nhất trong cộng đồng JanitorAI, và khuôn mẫu đằng sau nó có thể đoán được. Một proxy miễn phí hoặc dùng chung là một API key phục vụ hàng trăm hoặc hàng nghìn người dùng. Provider thực thi giới hạn theo key về request mỗi phút và token mỗi phút, nên khi traffic buổi tối ở Mỹ đạt đỉnh, tất cả mọi người dồn qua cùng một hạn mức và key bắt đầu từ chối request. Bạn không bị nhắm riêng. Cái xô chỉ đơn giản là trống, và nó được nạp lại chậm nhất đúng vào lúc nhiều người muốn chat nhất. Proxy miễn phí có một chế độ lỗi thứ hai: bản thân key chết. Key dùng chung bị thu hồi vì vi phạm chính sách hoặc hết số dư, lúc đó cùng một URL bắt đầu trả về 401 hoặc 404 thay vào đó, thường không có thông báo trước. Endpoint trả phí tránh được bức tường giờ cao điểm về mặt cấu trúc. Key của bạn có hạn mức riêng thay vì chia sẻ một cái xô với đám đông, tính phí theo token nên provider không có lý do gì để throttle bạn vào một tier subscription, và năng lực được cấp phát cho traffic trả phí. Nếu bạn thấy lỗi 429 trên một key trả phí cá nhân, đó gần như luôn là một giới hạn burst ngắn: chờ vài giây rồi thử lại, hoặc chậm lại việc regenerate liên tục. Lỗi 429 dai dẳng trên một key cá nhân đáng để mở support ticket, không phải một workaround.

Bảng lỗi proxy JanitorAI: 429, 401, 404, timeout

Đối chiếu mã lỗi JanitorAI hiển thị cho bạn với bảng này. Cột cách sửa giả định bạn đã xác nhận endpoint hoạt động với test curl ở trên; nếu curl cũng thất bại theo cùng cách, vấn đề nằm ở phía endpoint, không phải ở JanitorAI.

Nên chạy model nào đằng sau proxy Janitor AI của bạn

Việc chọn model quan trọng hơn bất kỳ điều chỉnh generation-settings nào. Đồng thuận cộng đồng khá ổn định: dòng DeepSeek V4 là lựa chọn được ưa chuộng nhất cho roleplay vì nó viết phản hồi dài, đúng chất nhân vật ở mức giá mà chi phí không còn là điều cần cân nhắc. GLM-5, Kimi K2.6 và MiMo là các lựa chọn giá trị đáng để xoay vòng khi bạn muốn một giọng văn khác. Grok 4.5 được liệt kê trong số các lựa chọn chính sách linh hoạt vì chính sách công khai của xAI cho phép chủ đề trưởng thành trong bối cảnh hư cấu rõ ràng cho người dùng trưởng thành. Claude Sonnet 4.6 viết văn mạnh nhất trong danh mục và phù hợp với viết sáng tạo SFW; chính sách Anthropic cấm nội dung explicit, nên hãy giữ nó cho các chat theo hướng câu chuyện, không explicit. Mọi giá danh mục dưới đây đều trả theo lượng dùng, không subscription. Model toàn cầu được định giá thấp hơn 20% mức giá chính thức và model Trung Quốc dưới giá chính thức, và lần nạp đầu tiên nhân đôi số dư khởi điểm của bạn.

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