# Zed (/vi/docs/guides/zed)

Dùng các mô hình cheapaimodel trong Zed Agent và các tính năng AI khác của Zed qua một nhà cung cấp tương thích OpenAI.



Zed thêm các dịch vụ tương thích OpenAI làm nhà cung cấp trong `language_models.openai_compatible` của `settings.json`. Sau đó, nhà cung cấp này phục vụ Zed Agent, Inline Assistant và các tính năng khác của Zed có dùng mô hình.

|            | Cài đặt Zed                                                  | Giá trị                                                                                    |
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
| Base URL   | `api_url`                                                    | `https://api.cheapaimodel.ai/v1`                                                           |
| API key    | Trang cài đặt **LLM Providers**, hoặc `CHEAPAIMODEL_API_KEY` | Key của bạn từ trang [API key](https://console.cheapaimodel.ai/keys) trong bảng điều khiển |
| ID mô hình | `available_models[].name`                                    | `glm-5.3`, hoặc bất kỳ ID nào trong [danh mục](/vi/models)                                 |

## Thiết lập [#set-it-up]

<Steps>
  <Step>
    ### Thêm nhà cung cấp [#add-the-provider]

    Chạy **zed: open settings file** từ command palette và thêm một nhà cung cấp:

    ```json title="~/.config/zed/settings.json"
    {
      "language_models": {
        "openai_compatible": {
          "cheapaimodel": {
            "api_url": "https://api.cheapaimodel.ai/v1",
            "available_models": [
              {
                "name": "glm-5.3",
                "display_name": "GLM-5.3",
                "max_tokens": CONTEXT_LENGTH
              }
            ]
          }
        }
      }
    }
    ```

    `max_tokens` là cửa sổ ngữ cảnh của mô hình. Thay `CONTEXT_LENGTH` bằng độ dài ngữ cảnh ghi trên trang của mô hình, ví dụ [glm-5.3](/vi/models/glm-5.3). Thêm một mục vào `available_models` cho mỗi ID mô hình.
  </Step>

  <Step>
    ### Thêm key của bạn [#add-your-key]

    Chạy **agent: open settings**, tìm **cheapaimodel** trong **LLM Providers** rồi dán key vào; Zed lưu key trong keychain của hệ thống. Bạn cũng có thể đặt `CHEAPAIMODEL_API_KEY` trong môi trường mà Zed khởi chạy, rồi khởi động lại Zed.
  </Step>

  <Step>
    ### Chọn mô hình [#pick-the-model]

    Mở Agent Panel và chọn **GLM-5.3** dưới **cheapaimodel** trong bộ chọn mô hình.
  </Step>
</Steps>

<Callout type="info">
  Edit predictions (gợi ý chỉnh sửa) được cấu hình riêng. Nhà cung cấp edit prediction tương thích OpenAI của Zed cần endpoint `/v1/completions` và một mô hình fill-in-the-middle; các mô hình của cheapaimodel chỉ phục vụ `/v1/chat/completions` và `/v1/responses`. Giữ nguyên Zeta hoặc một nhà cung cấp edit prediction khác.
</Callout>

## Lỗi thường gặp [#common-mistakes]

* **Zed báo nhà cung cấp chưa có API key.** Key không được đọc từ `settings.json`. Dán key vào trang **LLM Providers** hoặc đặt biến môi trường.
* **Biến môi trường bị bỏ qua, hoặc key cũ vẫn tiếp tục được dùng.** Zed lấy tên biến từ ID của nhà cung cấp: viết hoa, nối bằng gạch dưới (upper snake case), thêm `_API_KEY`. ID `cheapaimodel` sẽ đọc `CHEAPAIMODEL_API_KEY`; nếu bạn đổi tên nhà cung cấp, đổi tên biến cho khớp. Biến không rỗng được ưu tiên hơn keychain; xóa biến đó (unset) rồi khởi động lại Zed để dùng key bạn đã dán.
* **`404` kèm body văn bản thuần `fault filter abort`.** `api_url` thiếu `/v1`. Đặt thành `https://api.cheapaimodel.ai/v1`.
* **`404` kèm `Invalid URL (POST /v1/chat/completions/chat/completions)`.** `api_url` có kèm đường dẫn endpoint. Zed tự thêm `/chat/completions`; chỉ cần đặt `https://api.cheapaimodel.ai/v1`.
* **`503` kèm `model_not_found`.** `name` phải là một ID mô hình trong [danh mục](/vi/models), viết chính xác; `display_name` chỉ là nhãn hiển thị.