Chuyển đến nội dung chính
Trang này liệt kê các vấn đề phổ biến khi kết nối 4096bytes với ứng dụng khách. Khi kiểm tra, hãy bắt đầu từ ba giá trị: API Key, Base URL và tên mô hình.

​
Tham số kết nối

Ứng dụng tương thích OpenAI thường dùng https://api.4096bytes.com. Nếu bảng điều khiển hiển thị địa chỉ riêng cho ứng dụng trong hộp thoại Use key, hãy dùng giá trị đó.
Không tự nối đường dẫn API. Phần lớn ứng dụng chỉ cần Base URL gốc, đường dẫn cụ thể do ứng dụng tự thêm. Claude Code, Codex và Cursor có thể dùng định dạng khác nhau, nên hãy làm theo trang tương ứng.
Tên mô hình lấy theo bảng điều khiển. Khi sao chép, giữ nguyên chữ hoa/thường, số, dấu gạch nối và hậu tố phiên bản. Không sao chép từ ảnh cũ, tài liệu cũ hoặc cấu hình của người khác.
YOUR_4096BYTES_API_KEY và PASTE_MODEL_NAME_FROM_DASHBOARD là placeholder. API Key thật và tên mô hình thật cần sao chép từ bảng điều khiển. Giá trị cố định https://api.4096bytes.com là endpoint tương thích OpenAI hiện tại.

​
Quản lý API Key

Về kỹ thuật thì có, nhưng không khuyến nghị. Nên dùng key riêng cho Codex, Claude Code, Cursor và Cherry Studio. Cách này giúp xem nguồn tiêu thụ theo ứng dụng và chỉ cần vô hiệu hóa một key nếu bị lộ.
Thường là không. Hãy sao chép và lưu ngay sau khi tạo. Nếu quên lưu, nên xóa key cũ và tạo key mới.
Vào bảng điều khiển và xóa key bị lộ ngay. Sau đó tạo key mới và cập nhật cấu hình ứng dụng liên quan. Không tiếp tục dùng key đã xuất hiện trong ảnh chụp, log, chat hoặc repository công khai.
Với dùng cá nhân lâu dài, có thể chưa đặt. Với thử nghiệm tạm thời, thành viên nhóm, thiết bị dùng chung hoặc ứng dụng ít dùng, nên đặt hạn mức nhỏ để tránh tiêu thụ bất thường.

​
Lỗi thường gặp

401 thường nghĩa là API Key không hợp lệ, đã xóa, sao chép thiếu hoặc có ký tự thừa. Hãy sao chép lại từ bảng điều khiển và kiểm tra khoảng trắng, xuống dòng, dấu ngoặc thông minh hoặc ký tự ẩn.
403 thường liên quan đến quyền của key, nhóm, phạm vi mô hình hoặc trạng thái tài khoản. Xác nhận nhóm của key đang hoạt động và có chứa mô hình bạn gọi.
404 thường do Base URL sai hoặc ứng dụng ghép đường dẫn ở vị trí sai. Hãy dùng https://api.4096bytes.com và xóa đường dẫn endpoint đầy đủ tự thêm.
429 thường nghĩa là tần suất, song song hoặc hạn mức đã đạt giới hạn. Giảm song song, thử lại sau hoặc kiểm tra số dư, hạn mức key và giới hạn tốc độ trong bảng điều khiển.
Tên mô hình phải khớp hoàn toàn với bảng điều khiển. Sao chép lại tên mô hình và kiểm tra chữ hoa/thường, số, dấu gạch nối và hậu tố.
Base URL thường bị thiếu định dạng. Xác nhận địa chỉ bắt đầu bằng https://, không ghi thành api.4096bytes.com, không thêm khoảng trắng, dấu ngoặc hoặc xuống dòng.

​
Hành vi ứng dụng khách

Trước tiên hãy khởi động lại ứng dụng. Sau đó kiểm tra có nhiều vị trí cấu hình, nhiều Provider hoặc nhiều danh sách mô hình không. Xác nhận cuộc trò chuyện hiện tại chọn mô hình của 4096bytes.
API Key tùy chỉnh của Cursor không nhất thiết áp dụng cho mọi chức năng nội bộ. Hãy chọn mô hình 4096bytes trong Chat hoặc Agent. Tab, gợi ý hoàn thành, lập chỉ mục và tác vụ nền có thể vẫn dùng dịch vụ Cursor.
Claude Code đọc biến môi trường liên quan đến Anthropic. Hãy làm theo trang Claude Code, dùng ANTHROPIC_BASE_URL và biến xác thực tương ứng.
Xác nhận cấu hình mới nằm ở đầu ~/.codex/config.toml, và model_provider trỏ tới Provider 4096bytes. Lưu xong hãy mở lại terminal.
Nếu ứng dụng không tự lấy danh sách mô hình, hãy thêm thủ công tên mô hình được hiển thị trong bảng điều khiển. Sau đó chọn lại mô hình trong cuộc trò chuyện hiện tại.

​
Sử dụng và hiệu năng

Yêu cầu đầu tiên có thể bao gồm khởi tạo ứng dụng, kết nối mạng, khởi động mô hình hoặc xử lý ngữ cảnh dài. Hãy thử bằng câu hỏi ngắn trước rồi tăng dần độ dài ngữ cảnh.
Trước tiên giảm ngữ cảnh, tệp đính kèm và yêu cầu song song. Sau đó kiểm tra mạng cục bộ, proxy, log ứng dụng và bản ghi yêu cầu trong bảng điều khiển. Codebase lớn, hội thoại dài và nhiều Agent song song đều có thể tăng thời gian xử lý.
Cần kiểm tra thêm hạn mức key, thời hạn key, giới hạn tốc độ, trạng thái nhóm và mô hình có khả dụng không. Số dư tài khoản chỉ là một điều kiện.
Vào bảng điều khiển để xem bản ghi liên quan đến tài khoản, key hoặc nhóm. Để dễ định vị vấn đề, nên dùng key riêng cho từng ứng dụng khách.

​
Liên hệ hỗ trợ

Hãy cung cấp tên và phiên bản ứng dụng, nội dung lỗi, thời điểm yêu cầu, tên mô hình, Base URL, email hoặc định danh tài khoản và ảnh chụp cấu hình đã che thông tin nhạy cảm. Không gửi API Key đầy đủ.
Không gửi API Key đầy đủ, mật khẩu tài khoản, chứng từ thanh toán, nội dung repository riêng tư hoặc log đầy đủ có thông tin nhạy cảm. Hãy che key và thông tin cá nhân trước khi gửi ảnh.

​
Thứ tự kiểm tra khuyến nghị

  1. Sao chép lại API Key.
  2. Xác nhận Base URL là https://api.4096bytes.com hoặc địa chỉ riêng cho ứng dụng được hiển thị trong bảng điều khiển.
  3. Sao chép lại tên mô hình.
  4. Xác nhận loại Provider khớp với trang ứng dụng khách.
  5. Khởi động lại ứng dụng hoặc terminal.
  6. Kiểm tra số dư, hạn mức key, thời hạn, giới hạn tốc độ và trạng thái nhóm.
  7. Gửi thông tin đã che nhạy cảm cho hỗ trợ.
Nếu bạn chưa hoàn thành cấu hình cơ bản, hãy đọc Lấy API Key trước rồi mở trang ứng dụng tương ứng.