# Dify (/vi/docs/guides/dify)

Dùng các mô hình cheapaimodel trong ứng dụng và workflow của Dify qua nhà cung cấp mô hình OpenAI-API-compatible.



Dify kết nối với các dịch vụ tương thích OpenAI qua plugin nhà cung cấp mô hình **OpenAI-API-compatible**. Bạn thêm thủ công từng mô hình; sau đó mọi ứng dụng trong workspace đều dùng được.

|            | Cài đặt Dify     | Giá trị                                                                                    |
| ---------- | ---------------- | ------------------------------------------------------------------------------------------ |
| Base URL   | **API Base URL** | `https://api.cheapaimodel.ai/v1`                                                           |
| API key    | **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 | **Model Name**   | `deepseek-v4-1-flash`, hoặc bất kỳ ID nào trong [danh mục](/vi/models)                     |

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

<Steps>
  <Step>
    ### Cài nhà cung cấp [#install-the-provider]

    Với vai trò owner hoặc admin của workspace, mở **Integrations → Model Provider**. Tìm **OpenAI-API-compatible** trong **Install model providers**, hoặc trên Dify Marketplace, rồi cài đặt.
  </Step>

  <Step>
    ### Thêm mô hình [#add-a-model]

    Trên thẻ **OpenAI-API-compatible**, nhấn **Add Model** và điền:

    | Trường                         | Giá trị                                                                                                       |
    | ------------------------------ | ------------------------------------------------------------------------------------------------------------- |
    | **Model Type**                 | **LLM**                                                                                                       |
    | **Model Name**                 | `deepseek-v4-1-flash`                                                                                         |
    | **API Key**                    | Key cheapaimodel của bạn                                                                                      |
    | **API Base URL**               | `https://api.cheapaimodel.ai/v1`                                                                              |
    | **Completion mode**            | **Chat**                                                                                                      |
    | **Model context size**         | Độ dài ngữ cảnh ghi trên trang của mô hình, ví dụ [trang deepseek-v4-1-flash](/vi/models/deepseek-v4-1-flash) |
    | **Upper bound for max tokens** | Số token đầu ra tối đa ghi trên cùng trang đó                                                                 |

    Cả hai trường kích thước đều mặc định là `4096`, nên điền theo trang mô hình. Để trống **model name for API endpoint** và để **API Type** ở &#x2A;*Chat Completions API (/chat/completions)**. Các trường về khả năng, như **Function Call Type** và **Vision Support**, mặc định tắt; chỉ bật những khả năng bạn đã xác nhận là mô hình xử lý được.

    Nhấn **Save**. Trước khi lưu, Dify gửi một yêu cầu thử ngắn tới mô hình, nên nếu có trường sai thì lỗi sẽ hiện ở đây chứ không phải trong ứng dụng của bạn. Lặp lại cho từng ID mô hình bạn muốn.
  </Step>

  <Step>
    ### Sử dụng [#use-it]

    Chọn mô hình trong bộ chọn mô hình của một ứng dụng hoặc một node LLM, hoặc đặt làm mặc định cho workspace qua **Default Models → System Reasoning Model**.
  </Step>
</Steps>

## Cơ sở kiến thức [#knowledge-bases]

cheapaimodel chưa có mô hình embeddings. Đừng thêm mô hình **Text Embedding** trỏ tới cheapaimodel; với các cơ sở kiến thức của bạn, đặt **Default Models → Embedding Model** sang một nhà cung cấp khác.

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

* **Nhấn Save bị lỗi `Credentials validation failed with status code 404`, nội dung phản hồi là `fault filter abort`.** **API Base URL** thiếu `/v1`. Đặt thành `https://api.cheapaimodel.ai/v1`.
* **Nhấn Save bị lỗi mã `404`, nội dung phản hồi có `Invalid URL (POST /v1/chat/completions/chat/completions)`.** **API Base URL** có kèm đường dẫn endpoint. Dify tự thêm `/chat/completions`; đặt thành `https://api.cheapaimodel.ai/v1`.
* **Nhấn Save bị lỗi mã `401`.** Key sai, đã hết hạn hoặc đã dùng hết hạn mức chi tiêu. Kiểm tra key trong bảng điều khiển.
* **Nhấn Save bị lỗi mã `503` kèm `model_not_found`.** **Model Name** phải là một ID trong danh mục, viết chính xác. Nếu muốn nhãn dễ đọc hơn, điền vào **Model display name**.