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 頁面建立的 Key |
| 模型 ID | Model Name | deepseek-v4-1-flash,或目錄中的任一模型 ID |
設定
安裝供應商
以工作區擁有者或管理員身分開啟 Integrations → Model Provider。在 Install model providers 或 Dify Marketplace 中找到 OpenAI-API-compatible 並安裝。
加入模型
在 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 的頁面 |
| Upper bound for max tokens | 同一頁面上的最大輸出 token 數 |
這兩個長度欄位的預設值都是 4096,請依模型頁面填寫。model name for API endpoint 留空,API Type 維持 Chat Completions API (/chat/completions)。Function Call Type、Vision Support 等能力欄位預設關閉;只有確認過模型能處理的能力才開啟。
點選 Save。Dify 儲存前會先向模型送出一個簡短的測試請求,因此欄位填錯會在這一步失敗,而不是在你的應用程式中。要使用的每個模型 ID 都重複這個步驟。
使用模型
在應用程式或 LLM 節點的模型選單中選擇它,或透過 Default Models → System Reasoning Model 設為工作區預設。
知識庫
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。