> ## 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.

# Cherry Studio

> Thêm 4096bytes làm Provider trong Cherry Studio

Cherry Studio phù hợp để quản lý nhiều Provider mô hình trong một ứng dụng. Bạn có thể thêm 4096bytes làm Provider tương thích OpenAI rồi chọn mô hình tương ứng trong cuộc trò chuyện.

## Điều kiện trước

* Bạn đã hoàn thành [Tạo tài khoản](/vi/quickstart/create-account).
* Bạn đã hoàn thành [Lấy API Key](/vi/quickstart/get-api-key).
* Cherry Studio đã được cài và trang cài đặt mở bình thường.
* Bạn đã có API Key, Base URL và tên mô hình của 4096bytes.

Nên tạo API Key riêng cho Cherry Studio, ví dụ `cherry-studio-home` hoặc `cherry-studio-work`.

## Cài đặt

Nếu chưa cài Cherry Studio, mở [trang tải Cherry Studio](https://docs.cherry-ai.com/docs/en-us/cherry-studio/download) và chọn gói phù hợp với hệ điều hành.

<Steps>
  <Step title="Tải gói cài đặt">
    Chọn phiên bản Windows, macOS hoặc Linux từ trang chính thức. Người dùng Windows chú ý bản cài đặt và bản portable. Người dùng macOS chú ý Intel và Apple Silicon.
  </Step>

  <Step title="Khởi động Cherry Studio">
    Sau khi cài, mở Cherry Studio một lần và xác nhận giao diện chính hoạt động bình thường.
  </Step>

  <Step title="Mở cài đặt">
    Mở **Settings** và tìm trang dịch vụ mô hình, Provider hoặc cấu hình API.
  </Step>
</Steps>

## Thêm Provider

<Steps>
  <Step title="Mở cài đặt">
    Khởi động Cherry Studio và vào **Settings**. Vị trí có thể ở góc dưới bên trái hoặc thanh bên.
  </Step>

  <Step title="Vào dịch vụ mô hình">
    Tìm **Model services**, **Model providers**, **Provider** hoặc trang cấu hình API.
  </Step>

  <Step title="Thêm Provider">
    Nhấn **Add**, **New provider** hoặc nút tương tự. Tên Provider nên điền `4096bytes`.
  </Step>

  <Step title="Chọn loại tương thích">
    Chọn **OpenAI**, **OpenAI Compatible**, **Custom OpenAI** hoặc tùy chọn tương tự.
  </Step>
</Steps>

## Điền thông tin kết nối

| Trường Cherry Studio                  | Giá trị                                          |
| ------------------------------------- | ------------------------------------------------ |
| `Name`, `Provider name`               | `4096bytes`                                      |
| `API Key`, `Key`                      | API Key bạn tạo trong bảng điều khiển 4096bytes. |
| `API address`, `API Host`, `Base URL` | `https://api.4096bytes.com`.                     |
| `API type`, `Compatible type`         | Tương thích OpenAI.                              |
| `Model`, `Model name`                 | Tên mô hình hiển thị trong bảng điều khiển.      |

Chỉ điền Base URL gốc. Không tự thêm `/v1/chat/completions`, `/v1/responses` hoặc đường dẫn endpoint đầy đủ khác.

<Warning>
  API Key được lưu trong cấu hình Cherry Studio cục bộ. Không cấu hình key cá nhân trên máy dùng chung và không gửi ảnh chụp có chứa key.
</Warning>

## Thêm mô hình

Các phiên bản Cherry Studio xử lý danh sách mô hình khác nhau. Một số phiên bản có thể tự lấy danh sách, một số cần thêm thủ công.

<Steps>
  <Step title="Thử lấy danh sách mô hình">
    Nếu trang có nút **Fetch models**, **Refresh model list** hoặc **Check**, hãy thử trước.
  </Step>

  <Step title="Thêm mô hình thủ công">
    Nếu danh sách trống, nhấn **Add model** hoặc **Custom model** và nhập tên mô hình hiển thị trong bảng điều khiển.
  </Step>

  <Step title="Lưu Provider">
    Xác nhận Provider đã bật, rồi lưu API Key, Base URL và danh sách mô hình.
  </Step>
</Steps>

Tên mô hình phải khớp hoàn toàn với bảng điều khiển.

## Kiểm tra kết nối

Sau khi lưu, tạo một cuộc trò chuyện mới trong Cherry Studio và chọn mô hình dưới Provider 4096bytes.

Bạn có thể gửi câu hỏi ngắn:

```text theme={null}
Hãy nói trong một câu tên mô hình bạn đang sử dụng.
```

Nếu có phản hồi, Cherry Studio đã có thể gửi yêu cầu qua 4096bytes.

## Gợi ý sử dụng

* Tạo API Key riêng cho Cherry Studio.
* Nếu thêm nhiều Provider, kiểm tra mô hình đang chọn trước khi gửi tin nhắn.
* Nếu Cherry Studio hỗ trợ nhóm mô hình hoặc mô hình mặc định, có thể đặt mô hình 4096bytes thường dùng làm mặc định.
* Không nên cấu hình API Key cá nhân trên thiết bị dùng chung. Nếu phải dùng chung, hãy dùng key riêng và đặt hạn mức.

## Xử lý lỗi thường gặp

<AccordionGroup>
  <Accordion title="Kiểm tra kết nối thất bại">
    Xác nhận loại Provider là tương thích OpenAI, rồi kiểm tra API Key, Base URL và tên mô hình. Base URL dùng `https://api.4096bytes.com`, không điền đường dẫn endpoint đầy đủ.
  </Accordion>

  <Accordion title="Danh sách mô hình trống">
    Nếu Cherry Studio không tự lấy danh sách mô hình, hãy thêm thủ công tên mô hình từ bảng điều khiển. Sau khi thêm, lưu Provider và mở lại cuộc trò chuyện.
  </Accordion>

  <Accordion title="Xác thực thất bại">
    Kiểm tra API Key có đầy đủ không, có sao chép khoảng trắng hoặc xuống dòng thừa không. Xác nhận key chưa bị xóa, hết hạn hoặc vượt hạn mức.
  </Accordion>

  <Accordion title="Báo model not found">
    Sao chép lại tên mô hình từ bảng điều khiển. Tên phải khớp hoàn toàn và không lấy từ trang ứng dụng khác, ảnh cũ hoặc cấu hình của người khác.
  </Accordion>

  <Accordion title="Cuộc trò chuyện dùng Provider khác">
    Kiểm tra bộ chọn mô hình của cuộc trò chuyện hiện tại. Cherry Studio có thể giữ mô hình dùng lần trước, cần chuyển thủ công sang mô hình của Provider 4096bytes.
  </Accordion>

  <Accordion title="Yêu cầu chậm hoặc bị ngắt">
    Thử bằng câu hỏi ngắn trước. Ngữ cảnh dài, tệp đính kèm, proxy mạng hoặc nhiều yêu cầu song song đều có thể ảnh hưởng tốc độ. Khi cần, hãy xem log của Cherry Studio.
  </Accordion>
</AccordionGroup>