# Dify (/zh-Hant/docs/guides/dify)

透過 OpenAI-API-compatible 模型供應商，在 Dify 的應用程式與工作流程中使用 cheapaimodel 的模型。



Dify 透過 **OpenAI-API-compatible** 模型供應商外掛接上 OpenAI 相容的服務。每個模型都要手動加入，加入後工作區中的所有應用程式都能使用。

|          | Dify 設定          | 值                                                               |
| -------- | ---------------- | --------------------------------------------------------------- |
| Base URL | **API Base URL** | `https://api.cheapaimodel.ai/v1`                                |
| API Key  | **API Key**      | 在控制台的 [API Key](https://console.cheapaimodel.ai/keys) 頁面建立的 Key |
| 模型 ID    | **Model Name**   | `deepseek-v4-1-flash`，或[目錄](/zh-Hant/models)中的任一模型 ID           |

## 設定 [#設定]

<Steps>
  <Step>
    ### 安裝供應商 [#安裝供應商]

    以工作區擁有者或管理員身分開啟 **Integrations → Model Provider**。在 **Install model providers** 或 Dify Marketplace 中找到 **OpenAI-API-compatible** 並安裝。
  </Step>

  <Step>
    ### 加入模型 [#加入模型]

    在 **OpenAI-API-compatible** 卡片上點選 **Add Model**，填入：

    | 欄位                             | 值                                                                             |
    | ------------------------------ | ----------------------------------------------------------------------------- |
    | **Model Type**                 | **LLM**                                                                       |
    | **Model Name**                 | `deepseek-v4-1-flash`                                                         |
    | **API Key**                    | 你的 cheapaimodel Key                                                           |
    | **API Base URL**               | `https://api.cheapaimodel.ai/v1`                                              |
    | **Completion mode**            | **Chat**                                                                      |
    | **Model context size**         | 模型頁面上的上下文長度，例如 [deepseek-v4-1-flash 的頁面](/zh-Hant/models/deepseek-v4-1-flash) |
    | **Upper bound for max tokens** | 同一頁面上的最大輸出 token 數                                                            |

    這兩個長度欄位的預設值都是 `4096`，請依模型頁面填寫。**model name for API endpoint** 留空，**API Type** 維持 &#x2A;*Chat Completions API (/chat/completions)**。**Function Call Type**、**Vision Support** 等能力欄位預設關閉；只有確認過模型能處理的能力才開啟。

    點選 **Save**。Dify 儲存前會先向模型送出一個簡短的測試請求，因此欄位填錯會在這一步失敗，而不是在你的應用程式中。要使用的每個模型 ID 都重複這個步驟。
  </Step>

  <Step>
    ### 使用模型 [#使用模型]

    在應用程式或 LLM 節點的模型選單中選擇它，或透過 **Default Models → System Reasoning Model** 設為工作區預設。
  </Step>
</Steps>

## 知識庫 [#知識庫]

cheapaimodel 目前沒有 embedding 模型。不要加入指向 cheapaimodel 的 **Text Embedding** 模型；知識庫請把 **Default Models → Embedding Model** 設為其他供應商。

## 常見錯誤 [#常見錯誤]

* **儲存失敗，訊息為 `Credentials validation failed with status code 404`，主體為 `fault filter abort`。** **API Base URL** 漏了 `/v1`。請設定 `https://api.cheapaimodel.ai/v1`。
* **儲存失敗，狀態碼為 `404`，主體帶有 `Invalid URL (POST /v1/chat/completions/chat/completions)`。** **API Base URL** 含有端點路徑。Dify 會自行加上 `/chat/completions`；請設定 `https://api.cheapaimodel.ai/v1`。
* **儲存失敗，狀態碼為 `401`。** Key 錯誤、已到期或預算已用盡。請在控制台檢查。
* **儲存失敗，狀態碼為 `503` 且帶 `model_not_found`。** **Model Name** 必須是目錄中的模型 ID，拼寫完全一致。想用好讀的名稱，請填在 **Model display name**。