Skip to main content
Klien dan Alat Pengembang

Dify

Dify adalah platform open-source untuk membangun aplikasi AI. Anda dapat membangun aplikasi menggunakan API model dari Alibaba Cloud Model Studio.

Prasyarat

Anda perlu mendapatkan kunci API dan mengaktifkan layanan model yang diperlukan di Model Studio.
Dify adalah platform alur kerja dan otomatisasi, sehingga tidak mendukung Token Plan Personal Edition, Token Plan Team Edition, atau Coding Plan. Rencana ini hanya mendukung tool pemrograman AI dan agen tipe OpenClaw. Untuk informasi lebih lanjut, lihat Jenis tool yang tidak didukung.Gunakan kunci API pay-as-you-go dengan Dify. Penggunaan kunci API rencana untuk panggilan di luar cakupan yang diizinkan akan dianggap sebagai pelanggaran atau penyalahgunaan, dan dapat mengakibatkan penangguhan langganan atau pemblokiran kunci API.

1. Konfigurasikan model

1.1. Instal penyedia model

Buka Dify Marketplace. Di bawah Model, temukan Qwen dan instal versi terbaru plugin tersebut.
  • Plugin TONGYI dikelola oleh Dify, bukan Alibaba Cloud. Jika Anda mengalami error saat menginstal versi terbaru, coba instal versi sebelumnya.
  • Untuk menggunakan model DeepSeek dari Model Studio, Anda juga harus menggunakan plugin Qwen.

1.2. Konfigurasikan kunci API

Di pojok kanan atas halaman, klik foto profil Anda → Settings. Di bawah Model Providers, temukan kartu Qwen dan klik Settings.
  • Jika Anda menggunakan model dari wilayah Singapura, buka bagian API-KEY Settings, masukkan kunci API untuk wilayah tersebut, dan atur Use International Endpoint ke Yes.
  • Jika Anda menggunakan model dari wilayah Beijing, buka bagian API-KEY Settings, masukkan kunci API untuk wilayah Beijing, dan atur Use International Endpoint ke No.
Jika Anda menerima error Invalid API key provided selama konfigurasi, lihat catatan tentang versi plugin di bagian 1.1. Instal penyedia model.
20251127172111

1.3. Pilih model

Pada kartu Qwen, klik untuk menampilkan daftar model, lalu aktifkan sakelar untuk model yang Anda butuhkan.
Jika plugin tidak menyertakan model Qwen terbaru, Anda dapat menginstal plugin OpenAI-API-compatible. Di pengaturan plugin, atur API endpoint URL ke salah satu berikut: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 (wilayah Singapura) atau https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 (wilayah Beijing). Ganti WorkspaceId dengan ID Workspace Anda yang sebenarnya.

2. Memulai

Dify mendukung beberapa jenis aplikasi. Pilih jenis aplikasi Anda untuk mendapatkan petunjuk.
  • Asisten chat dan agen
  • Chatflow dan alur kerja
  • Basis pengetahuan
  1. Buat asisten chat atau agen Di workspace, klik Create blank app. Di bawah Beginner-Friendly, buat dan buka asisten chat atau agen.
  2. Pilih model Di pojok kanan atas halaman aplikasi, pilih model. Misalnya, di bawah Qwen, pilih qwen-plus-latest(Qwen3), lalu aktifkan mode thinking.
  3. Uji percakapan Masukkan "Who are you?" Model akan memberikan respons setelah proses thinking-nya selesai. Anda juga dapat menggunakan model Qwen-VL atau QVQ untuk mengajukan pertanyaan tentang gambar. Setelah memilih model vision, sakelar Vision akan muncul di sebelah kiri. Aktifkan sakelar tersebut untuk mengunggah gambar di jendela chat di sebelah kanan.

FAQ

Q1: Error kunci API plugin TONGYI

A: Penyebab umum:
  • Versi terbaru plugin mungkin tidak stabil. Lihat catatan tentang versi plugin di bagian 1.1. Instal penyedia model.
  • Anda menggunakan kunci API dari sub-workspace. Versi 0.0.41 plugin TONGYI memvalidasi izin pemanggilan untuk model qwen-turbo. Anda harus memberikan izin pemanggilan untuk qwen-turbo.
    Plugin TONGYI tidak dikelola oleh Alibaba Cloud, dan kebijakan validasinya dapat berubah di versi mendatang. Gunakan kunci API dari workspace default.
  • Pengaturan endpoint salah. Atur Use International Endpoint dengan benar berdasarkan wilayah kunci API Anda.

Q2: Menggunakan modelQwen-Omni dan Qwen-OCR

A: Model-model ini tidak dapat dikonfigurasi langsung di Dify. Anda dapat mengintegrasikannya menggunakan node HTTP dalam Chatflow atau alur kerja. Untuk detail integrasi, rujuk contoh perintah cURL dalam dokumentasi model tersebut.
Untuk mengurangi risiko timeout pada node HTTP, gunakan keluaran streaming untuk panggilan API.

Q3: Menggunakan model Wan

A: Dify tidak menyediakan plugin khusus untuk model Wan. Namun, Anda dapat mencapai generasi teks-ke-gambar dan teks-ke-video menggunakan node dalam Chatflow atau alur kerja Dify. Ikuti langkah-langkah berikut:
  1. Unduh dan impor templat alur kerja Unduh salah satu templat siap pakai kami: Wan - Text-to-Image Demo.yml atau Wan - Text-to-Video Demo.yml. Di workspace, klik Import DSL File dan pilih templat yang telah Anda unduh.
  2. Konfigurasikan variabel lingkungan Di halaman alur kerja, temukan ikon variabel lingkungan image.png, dan ubah nilai DASHSCOPE_API_KEY menjadi kunci API Anda.
  3. Uji output Klik tombol Run untuk menghasilkan output. Misalnya, memasukkan "a small cat" dalam alur kerja teks-ke-gambar akan menghasilkan sebuah gambar.
    Alur kerja teks-ke-video mengembalikan URL video yang dihasilkan.
    Generasi teks-ke-video biasanya membutuhkan waktu lima menit atau lebih.
  4. Publish as a tool (opsional) Untuk menggunakan kemampuan ini di aplikasi lain, klik Publish di pojok kanan atas dan pilih Publish as tool.
Templat menggunakan model dari wilayah Singapura: wan2.2-t2i-flash (teks-ke-gambar) dan wan2.1-t2v-turbo (teks-ke-video). Anda dapat mengganti model di node STEP1 dan memodifikasi endpoint API spesifik wilayah di node STEP1 dan STEP3.

Q4: Penerapan Dify secara privat

A: Layanan cloud Dify memiliki beberapa batasan, seperti maksimal lima aplikasi. Untuk penerapan privat, lihat solusi Alibaba Cloud untuk penerapan Dify.
Rencana Token (Team Edition)
Model playground
  • Pembuatan audio
  • Pembuatan musik
Statistik dan Pemantauan
Asset Center
Dukungan layanan