Thêm toàn bộ model trong catalog vào Chatbox chỉ với một custom provider.

Câu trả lời nhanh: một hộp thoại trong cài đặt Model Provider.

Mở Settings của Chatbox và chuyển sang tab Model Provider. Nhấn Add, rồi Add Custom Provider. Điền hộp thoại với năm giá trị: một Name (APIsRouter), API Mode đặt thành OpenAI API Compatible, key của bạn trong API Key, https://api.apisrouter.com/v1 trong API Host, và để nguyên API Path ở mặc định /chat/completions mà Chatbox tự điền cho một host kết thúc ở /v1. Sau đó thêm model. Nút Fetch kéo danh sách model của endpoint qua /v1/models để bạn bật id từ catalog trực tiếp, và New cho phép bạn gõ tay một id nếu bạn muốn một picker ngắn được chọn lọc. Nhấn Check cạnh field key và Chatbox chạy một request trực tiếp; xác nhận màu xanh nghĩa là provider đã được nối đúng. Chúng tôi đã xác thực chính xác luồng này với web app Chatbox hiện tại, và cùng hộp thoại đó có trong các bản desktop và mobile.

Cách Chatbox nói chuyện với một custom provider.

Chatbox (chatboxai trên GitHub, khoảng 41K sao) là một trong những chat client AI được cài đặt nhiều nhất: app native cho Windows, macOS, và Linux, bản mobile cho iOS và Android, và một phiên bản trình duyệt tại web.chatboxai.app. Nó đi kèm các entry chính chủ cho các vendor lớn, mỗi cái đều muốn key riêng, và hộp thoại custom provider là con đường được ghi tài liệu cho mọi thứ khác. Một custom provider ở mode OpenAI API Compatible là một mô tả đơn thuần của một endpoint: host, path, key, và một danh sách model id. Mỗi lượt trò chuyện trở thành một request chat-completions chuẩn tới host đó, với model id từ picker di chuyển như một chuỗi. Chatbox không quan tâm vendor nào huấn luyện model đứng sau một id, đó chính xác là điều khiến một gateway đa vendor hữu ích ở đây: một provider entry đặt claude-sonnet-4-6, gpt-5.5, gemini-3.5-flash, và deepseek-v4-flash vào cùng một picker, thanh toán qua cùng một key. Sự khác biệt thực tế so với việc xếp chồng bốn provider chính chủ không chỉ là ít key hơn. Cài đặt Chatbox đồng bộ theo từng thiết bị, nên mỗi tài khoản vendor bạn thêm là một key nữa phải dán vào điện thoại, laptop, và web app của bạn. Một custom provider là một lần dán cho mỗi thiết bị, và chuyển một cuộc trò chuyện từ Claude sang DeepSeek chỉ là đổi trong picker chứ không phải đổi provider.

Cài đặt đầy đủ: từng field trong hộp thoại.

Name chỉ là một nhãn; APIsRouter giữ picker dễ đọc. API Mode phải là OpenAI API Compatible, điều này báo cho Chatbox nói chat completion chuẩn; mode còn lại trong dropdown dành cho endpoint gốc Gemini và không phải thứ một gateway cần. API Host và API Path ghép thành URL request, và cặp này là nơi cấu hình dễ sai. Với host đặt thành https://api.apisrouter.com/v1, path là /chat/completions, và Chatbox tự điền chính xác như vậy khi nó nhận ra một host /v1. Tài liệu Chatbox cũng mô tả quy ước host trần, nơi host bỏ /v1 và path mặc định là /v1/chat/completions; cả hai đều ghép thành cùng một URL, nên chọn một hình dạng và để field còn lại ở mặc định. Điều làm hỏng là trộn cả hai, một host /v1 với một path /v1/chat/completions, tạo ra một URL /v1/v1 nhân đôi báo 404. Nhãn field và hành vi tự điền thay đổi một chút giữa các bản Chatbox, nên hãy tin vào URL đã ghép hơn là trí nhớ. Với model, Fetch là con đường ít công sức nhất: Chatbox liệt kê mọi thứ endpoint phục vụ và bạn bật những cái bạn muốn. New là con đường chọn lọc: gõ tay id và picker luôn ngắn. Mỗi dòng model có công tắc capability (vision, tool use); để tắt trừ khi bạn biết model hỗ trợ capability đó, vì một model chưa cấu hình được xử lý như văn bản thuần và đó là mặc định an toàn. Hoàn tất với Check, rồi bắt đầu một cuộc trò chuyện và chọn một model dưới tên provider mới của bạn.

Name:      APIsRouter
API Mode:  OpenAI API Compatible
API Key:   sk-YOUR-APISROUTER-KEY
API Host:  https://api.apisrouter.com/v1
API Path:  /chat/completions   (autofilled)

Models: Fetch (pull the catalog) or New (type ids)
Then:   Check → green confirmation

Chọn model cho một chat client dùng hàng ngày.

Vì mọi model đã bật đều thanh toán qua một key, so sánh hai id chỉ là chuyển đổi trong picker chứ không phải một quyết định tài khoản. Chạy cùng loại cuộc trò chuyện trên cả hai trong vài ngày, sau đó đọc chi phí theo từng model trong console APIsRouter và giữ lại cái nào xứng đáng.

• Câu hỏi hàng ngày và viết lại nhanh là công việc dạng burst. claude-haiku-4-5-20251001 và gemini-3.5-flash trả lời đủ nhanh để app cảm giác tức thì, và chúng gánh tốt hầu hết traffic hàng ngày.
• Soạn thảo dài, lý luận cẩn trọng, và thảo luận code xứng đáng với claude-sonnet-4-6 hoặc gpt-5.5. Giữ bật một model cho mỗi tier và chuyển đổi theo từng cuộc trò chuyện thay vì theo từng provider.
• deepseek-v4-flash là lựa chọn khối lượng lớn nếu Chatbox là sidebar luôn mở của bạn; các cuộc trò chuyện nhỏ liên tục cộng dồn lại, và tier nhanh giữ cho số dư giảm chậm.
• Cuộc trò chuyện có input ảnh cần một id hỗ trợ vision với công tắc vision được bật ở dòng model đó; xác nhận capability với tài liệu model trước khi bật công tắc.
• Bật ít model một cách có chủ đích thay vì fetch mọi thứ: mỗi toggle là một dòng picker, và thêm một id khác sau này chỉ là một chỉnh sửa mười giây.

Trả theo mức sử dụng · thấp hơn giá chính thức

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Các lỗi thường gặp riêng của Chatbox.

Path bị nhân đôi là kinh điển nhất. Lỗi 404 trên mọi tin nhắn nghĩa là API Host và API Path đều mang /v1, hoặc path lặp lại thứ host đã kết thúc bằng; mở provider entry và đọc hai field như một URL. Kết quả rỗng từ Fetch thường có nghĩa là key sai hoặc thiếu, vì bản thân việc liệt kê model đã là một request có xác thực. Kiểm tra field API Key và dùng nút Check, nó hiện lỗi xác thực trực tiếp. Một model chỉ báo lỗi trong một số cuộc trò chuyện thường là do công tắc capability: vision được bật trên một model không có input ảnh, hoặc một luồng phụ thuộc tool chạm vào một model đã tắt tool. Đặt lại dòng model về mặc định và bật lại từng capability một. Và hãy nhớ provider entry tồn tại theo từng bản cài đặt. Thêm APIsRouter trên desktop không cấu hình cho điện thoại của bạn; lặp lại hộp thoại ở đó, hoặc dùng tính năng chia sẻ config riêng của Chatbox nếu phiên bản của bạn có. Điều duy nhất không bao giờ cần lặp lại là đăng ký vendor, vì một key bao phủ mọi model trên mọi thiết bị.

Ai định tuyến Chatbox qua một gateway.

• Người muốn Claude, GPT, Gemini, và DeepSeek trong một picker mà không phải duy trì bốn tài khoản vendor và bốn key trên ba thiết bị.
• Người dùng ở các khu vực mà việc đăng ký một số vendor gặp khó khăn; truy cập dựa trên nạp tiền không yêu cầu thẻ loại bỏ sự phụ thuộc theo từng provider.
• Lập trình viên đã định tuyến editor và công cụ terminal của họ qua một gateway và muốn chat client của họ nằm trên cùng key và cùng usage log.
• Người "đi chợ" model, so sánh id trên các cuộc trò chuyện thực trước khi cam kết một project với một cái; mỗi ứng viên chỉ là một dòng picker, không phải một tài khoản.
• Hộ gia đình và team nhỏ chuẩn hóa trên một endpoint, một số dư, và khả năng nhìn thấy usage theo từng key thay vì các subscription rải rác.

Xác minh endpoint và debug tin nhắn đầu tiên.

Chứng minh phần gateway bên ngoài Chatbox trước: liệt kê model bằng key của bạn, sau đó chạy một chat completion với một id bạn định bật. Nếu cả hai đều pass, mọi thứ còn lại nằm ở hộp thoại provider. Bên trong Chatbox, nút Check là tín hiệu nhanh nhất. Lỗi xác thực là field key. Lỗi not-found khi gửi là id không khớp, điều này chủ yếu xảy ra với các entry New gõ tay; copy id từ output của /v1/models thay vì nhớ. Lỗi 404 trên mọi request là do cách ghép host/path đã nói ở trên. Khi tin nhắn đã thông suốt, console APIsRouter hiển thị model, số token, và chi phí theo từng request. Một chat client tạo ra nhiều request nhỏ suốt cả ngày, và usage log là nơi thói quen đó trở thành một con số theo từng model, từng ngày mà bạn thực sự đọc được.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

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