> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4096bytes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Xử lý các lỗi thường gặp khi kết nối ứng dụng khách với 4096bytes

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

<AccordionGroup>
  <Accordion title="Base URL nên điền gì?">
    Ứ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ị đó.
  </Accordion>

  <Accordion title="Có cần tự thêm /v1, /chat/completions hoặc /messages không?">
    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.
  </Accordion>

  <Accordion title="Lấy tên mô hình ở đâu?">
    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.
  </Accordion>

  <Accordion title="Có thể sao chép trực tiếp giá trị ví dụ không?">
    `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.
  </Accordion>
</AccordionGroup>

## Quản lý API Key

<AccordionGroup>
  <Accordion title="Nhiều ứng dụng có thể dùng chung một API Key không?">
    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ộ.
  </Accordion>

  <Accordion title="Sau khi tạo có thể xem lại API Key đầy đủ không?">
    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.
  </Accordion>

  <Accordion title="API Key bị lộ thì làm gì?">
    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.
  </Accordion>

  <Accordion title="Có nên đặt hạn mức cho API Key không?">
    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.
  </Accordion>
</AccordionGroup>

## Lỗi thường gặp

<AccordionGroup>
  <Accordion title="401 hoặc xác thực thất bại">
    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.
  </Accordion>

  <Accordion title="403 hoặc không có quyề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.
  </Accordion>

  <Accordion title="404 hoặc endpoint không tồn tạ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.
  </Accordion>

  <Accordion title="429 hoặc quá nhiều yêu cầu">
    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.
  </Accordion>

  <Accordion title="Báo model not found">
    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ố.
  </Accordion>

  <Accordion title="Báo unsupported protocol hoặc invalid URL">
    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.
  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="Lưu cấu hình rồi vẫn lỗi">
    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.
  </Accordion>

  <Accordion title="Vì sao Cursor vẫn dùng mô hình chính thức?">
    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.
  </Accordion>

  <Accordion title="Vì sao Claude Code đã cấu hình Base URL nhưng không hiệu lực?">
    Claude Code đọc biến môi trường liên quan đến Anthropic. Hãy làm theo trang [Claude Code](/vi/clients/claude-code), dùng `ANTHROPIC_BASE_URL` và biến xác thực tương ứng.
  </Accordion>

  <Accordion title="Codex vẫn dùng mô hình cũ">
    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.
  </Accordion>

  <Accordion title="Cherry Studio hoặc ứng dụng khác không hiển thị mô hình">
    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.
  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="Vì sao yêu cầu đầu tiên chậm?">
    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.
  </Accordion>

  <Accordion title="Phản hồi chậm thì kiểm tra gì?">
    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ý.
  </Accordion>

  <Accordion title="Số dư đủ nhưng yêu cầu vẫn lỗi">
    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.
  </Accordion>

  <Accordion title="Xem bản ghi yêu cầu hoặc mức dùng ở đâu?">
    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.
  </Accordion>
</AccordionGroup>

## Liên hệ hỗ trợ

<AccordionGroup>
  <Accordion title="Khi liên hệ hỗ trợ cần cung cấp gì?">
    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 đủ.
  </Accordion>

  <Accordion title="Không nên gửi thông tin nào?">
    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.
  </Accordion>
</AccordionGroup>

## 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](/vi/quickstart/get-api-key) trước rồi mở trang ứng dụng tương ứng.