Trang chủ → Hướng dẫn → Chatbox với API tùy chỉnh: host, path, Claude và tạo ảnh

Chatbox với API tùy chỉnh: host, path, Claude và tạo ảnh

Trong Chatbox, API tùy chỉnh có thể hỏng ở ba chỗ: cặp API Host và API Path, chế độ Claude cần /v1 trong khi Claude Code lại cấm, và Image Creator bỏ qua hoàn toàn nhà cung cấp tùy chỉnh. Chúng tôi đã đọc mã nguồn Chatbox 1.23.5, thử mọi tổ hợp trên cổng của mình và tổng hợp các lỗi người dùng Chatbox thật gặp phải.

Thêm nhà cung cấp

1. Mở Settings → Model Provider rồi bấm Add Custom Provider. Đặt tên và chọn API Mode là OpenAI API Compatible.
2. Nhập https://apiclan.us vào API Host và để trống API Path.
3. Dán khóa API từ bảng điều khiển.
4. Bấm Fetch để tải các model thuộc nhóm của khóa, rồi Check để xác nhận khóa hoạt động.

API Host	API Path	Chatbox gọi
https://apiclan.us	(trống)	/v1/chat/completions ✓
https://apiclan.us/v1	/chat/completions	/v1/chat/completions ✓
https://apiclan.us	/chat/completions	/chat/completions ✗ 404

Chatbox chỉ thêm /v1 vào host khi API Path để trống. Khi bạn nhập path, host được dùng nguyên vẹn — nên https://apiclan.us kèm /chat/completions sẽ bỏ mất /v1 và trả về 404 với nội dung rỗng. Hãy để trống path hoặc đưa /v1 vào host.

Thêm Claude

Có hai cách, và quy tắc địa chỉ khác nhau:

API Mode	API Host	Chatbox gọi
OpenAI API Compatible	https://apiclan.us	/v1/chat/completions ✓
Claude API Compatible	https://apiclan.us/v1	/v1/messages ✓
Claude API Compatible	https://apiclan.us	/messages ✗ 404

Đơn giản nhất là tạo thêm một nhà cung cấp tùy chỉnh ở chế độ OpenAI API Compatible với khóa của nhóm Claude — 29 trong 43 yêu cầu Chatbox chúng tôi ghi nhận là claude-fable-5-1 gửi đúng theo cách này. Nếu bạn chọn Claude API Compatible, host phải kết thúc bằng /v1, vì Chatbox chỉ thêm /messages. Điều này ngược với Claude Code, nơi ANTHROPIC_BASE_URL không được chứa /v1.

Tạo ảnh trong Chatbox

Image Creator chỉ liệt kê nhà cung cấp OpenAI tích hợp (cùng với của chính Chatbox và Gemini). Nhà cung cấp tùy chỉnh được viết cứng là không có model ảnh và báo lỗi Provider doesnt support image generation.

1. Mở Settings → Model Provider → OpenAI (cái tích hợp sẵn, không phải nhà cung cấp tùy chỉnh của bạn).
2. Đặt API Host là https://api.apiclan.us và dán khóa tạo trong nhóm ảnh.
3. Thêm model gpt-image-2.5 và đặt Model Type là Image.
4. Mở Image Creator và chọn gpt-image-2.5.

Giữ các model chat trong nhà cung cấp tùy chỉnh: mỗi khóa chỉ thuộc một nhóm, nên khóa ảnh trong nhà cung cấp OpenAI không chạy được model chat GPT. Chúng tôi dùng api.apiclan.us ở đây vì ảnh lớn có thể mất vài phút, còn địa chỉ chính cắt phản hồi sau 100 giây. Yêu cầu thử theo định dạng của Chatbox trả về ảnh 1024×1024 trong 21 giây.

Chi phí của các yêu cầu Chatbox thật

Toàn bộ 43 yêu cầu Chatbox đến cổng của chúng tôi trong 30 ngày tính đến 12/10/2026, tất cả đều streaming qua /v1/chat/completions:

Model	Số yêu cầu	Token đầu (trung vị)	Trung bình mỗi tin nhắn
claude-fable-5-1	29	5.2 s	$0.039
gpt-6-astra	8	1.4 s	$0.006
gpt-5.6-sol	6	7.6 s	$0.004

Ở đây một câu trả lời của Claude tốn khoảng bảy lần câu trả lời của GPT, chủ yếu vì câu trả lời dài hơn (trung bình 622 token đầu ra). Chatbox gửi lại toàn bộ hội thoại mỗi lượt, nhưng với Claude trung bình 4.071 token mỗi yêu cầu được tính là đọc bộ nhớ đệm thay vì đầu vào giá đầy đủ, nhờ đó hội thoại dài vẫn rẻ. gpt-5.6-sol rẻ nhất nhưng bắt đầu chậm nhất, vì nó suy luận trước khi trả lời.

Lỗi người dùng Chatbox thật đã gặp

• 404 với nội dung rỗng → điền API Path mà host không có /v1, hoặc Claude API Compatible thiếu /v1. Xem các bảng ở trên.
• 400 This model is not supported on the Chat Completions endpoint → đã chọn gpt-image-2.5 làm model chat. Model ảnh chỉ chạy trong Image Creator.
• 403 Image generation is not enabled for this group → khóa trong nhà cung cấp OpenAI không thuộc nhóm ảnh.
• 404 model_not_found (is not supported by any configured account in this group) → model không có trong nhóm của khóa (một người dùng tự gõ gpt-5.2-pro, model chúng tôi không cung cấp). Hãy dùng Fetch thay vì gõ tên.
• Provider doesnt support image generation → Image Creator đang trỏ tới nhà cung cấp tùy chỉnh. Hãy dùng nhà cung cấp OpenAI tích hợp.

Ứng dụng desktop khác: Cherry Studio với API tùy chỉnh · Base URL cho Claude Code.

Bắt đầu sử dụng

Không thuê bao, không mức tối thiểu hàng tháng, không cần gọi cho nhân viên bán hàng. Nạp bằng USDT và tiêu đúng phần bạn dùng — 1 USDT cho bạn 2 tín dụng số dư API.

Đọc hướng dẫn nhanh 30 giây

Ngôn ngữ: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Giá trên trang này được điền tự động từ dữ liệu thanh toán thực tế. Điều khoản bên thứ ba được trích từ tài liệu của chính họ.