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

Pakai model cheapaimodel di aplikasi dan workflow Dify lewat penyedia model OpenAI-API-compatible.



Dify terhubung ke layanan yang kompatibel dengan OpenAI lewat plugin penyedia model **OpenAI-API-compatible**. Kamu menambahkan setiap model secara manual, lalu semua aplikasi di workspace bisa memakainya.

|          | Pengaturan Dify  | Nilai                                                                           |
| -------- | ---------------- | ------------------------------------------------------------------------------- |
| Base URL | **API Base URL** | `https://api.cheapaimodel.ai/v1`                                                |
| API key  | **API Key**      | Key kamu dari halaman [API key](https://console.cheapaimodel.ai/keys) di Konsol |
| ID model | **Model Name**   | `deepseek-v4-1-flash`, atau ID apa pun dari [katalog](/id/models)               |

## Penyiapan [#set-it-up]

<Steps>
  <Step>
    ### Pasang penyedianya [#install-the-provider]

    Sebagai pemilik atau admin workspace, buka **Integrations → Model Provider**. Cari **OpenAI-API-compatible** di **Install model providers** atau di Dify Marketplace, lalu pasang.
  </Step>

  <Step>
    ### Tambahkan model [#add-a-model]

    Di kartu **OpenAI-API-compatible**, klik **Add Model**, lalu isi:

    | Kolom                          | Nilai                                                                                                                 |
    | ------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
    | **Model Type**                 | **LLM**                                                                                                               |
    | **Model Name**                 | `deepseek-v4-1-flash`                                                                                                 |
    | **API Key**                    | Key cheapaimodel kamu                                                                                                 |
    | **API Base URL**               | `https://api.cheapaimodel.ai/v1`                                                                                      |
    | **Completion mode**            | **Chat**                                                                                                              |
    | **Model context size**         | Panjang konteks yang tertera di halaman model, misalnya [halaman deepseek-v4-1-flash](/id/models/deepseek-v4-1-flash) |
    | **Upper bound for max tokens** | Jumlah maksimum token output yang tertera di halaman yang sama                                                        |

    Kedua kolom ukuran awalnya berisi `4096`, jadi isi sesuai halaman model. Biarkan **model name for API endpoint** kosong dan **API Type** di &#x2A;*Chat Completions API (/chat/completions)**. Kolom kemampuan, seperti **Function Call Type** dan **Vision Support**, awalnya nonaktif; aktifkan hanya kemampuan yang sudah kamu pastikan bisa ditangani modelnya.

    Klik **Save**. Sebelum menyimpan, Dify mengirim permintaan uji singkat ke model, jadi kalau ada kolom yang salah, gagalnya di sini, bukan di aplikasimu. Ulangi untuk setiap ID model yang kamu mau.
  </Step>

  <Step>
    ### Pakai modelnya [#use-it]

    Pilih model itu di pemilih model sebuah aplikasi atau node LLM, atau jadikan default workspace lewat **Default Models → System Reasoning Model**.
  </Step>
</Steps>

## Basis pengetahuan [#knowledge-bases]

cheapaimodel belum punya model embeddings. Jangan tambahkan model **Text Embedding** yang mengarah ke cheapaimodel; untuk basis pengetahuanmu, atur **Default Models → Embedding Model** ke penyedia lain.

## Kesalahan umum [#common-mistakes]

* **Save gagal dengan `Credentials validation failed with status code 404` dan isi respons `fault filter abort`.** **API Base URL** tidak menyertakan `/v1`. Atur ke `https://api.cheapaimodel.ai/v1`.
* **Save gagal dengan kode status `404` dan `Invalid URL (POST /v1/chat/completions/chat/completions)` di isi respons.** **API Base URL** menyertakan path endpoint. Dify sudah menambahkan `/chat/completions` sendiri; atur ke `https://api.cheapaimodel.ai/v1`.
* **Save gagal dengan kode status `401`.** Key-nya salah, sudah kedaluwarsa, atau anggarannya habis. Cek di Konsol.
* **Save gagal dengan kode status `503` dan `model_not_found`.** **Model Name** harus berupa ID katalog, ditulis persis sama. Kalau mau label yang lebih mudah dibaca, isi di **Model display name**.