All Products
Search

This Product

    Alibaba Cloud Model Studio:Dify

    Document Center

    Alibaba Cloud Model Studio:Dify

    Last Updated:Jul 08, 2026

    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.

    1. Konfigurasi model

    1.1. Instal penyedia model

    Buka Dify Marketplace. Di bawah Model, temukan Qwen dan instal versi terbaru plugin tersebut.

    Catatan

    • 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. Konfigurasi 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, coba instal versi sebelumnya dari plugin TONGYI.

    20251127172111

    1.3. Pilih model

    Pada kartu Qwen, klik untuk menampilkan daftar model, lalu aktifkan sakelar untuk model yang Anda butuhkan.

    Jika plugin tidak mencakup 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://dashscope.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

    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.

    Chatflow dan workflow

    1. Buat Chatflow atau Workflow

      Di workspace, buat dan buka Chatflow atau workflow.

    2. Tambahkan Node LLM

      Tambahkan node LLM ke kanvas. Pilih node tersebut untuk membuka panel editnya, lalu pilih model yang Anda butuhkan. Untuk contoh ini, pilih qwen-plus-2025-07-28(Qwen3) dan aktifkan mode thinking.

      Jika Anda menggunakan model Qwen-VL atau QVQ , Anda harus mengaktifkan sakelar Vision untuk node LLM:

      Di bagian bawah panel edit node LLM, temukan dan aktifkan sakelar Vision. Anda kemudian dapat mengatur Resolution ke High atau Low.

    3. Jalankan node LLM

      Klik Add message. Di bidang pesan yang sesuai dengan USER, masukkan pertanyaan "Who are you?", lalu klik tombol run 20251127203142 di pojok kanan atas node.

      Setelah eksekusi selesai, periksa bidang text dalam output. Proses thinking dibungkus dalam tag ..., diikuti oleh respons utama model.

      Bidang text yang dikembalikan oleh node LLM berisi proses thinking dan respons. Anda dapat menggunakan node eksekusi kode Dify dengan ekspresi reguler untuk mengekstrak keduanya secara terpisah.

    Basis pengetahuan

    1. Buat Basis Pengetahuan

      Buat dan buka basis pengetahuan.

    2. Pilih Sumber Data

      Unggah file basis pengetahuan Anda.

    3. Segmentasi dan Pembersihan Teks

      Konfigurasikan model penyematan dan rerank dari Model Studio. Contoh ini menggunakan text-embedding-v4 dan gte-rerank-v2. Sesuaikan parameter lain sesuai kebutuhan.

      Model gte-rerank-v2 hanya didukung di wilayah Beijing.
      Model multimodal-embedding-v1 saat ini tidak dapat dipilih sebagai model penyematan. Nantikan pembaruan di masa mendatang.

    FAQ

    Q1: Error kunci API plugin TONGYI

    A: Penyebab umum:

    • Versi terbaru plugin mungkin tidak stabil. Coba instal versi sebelumnya.

    • 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 model Qwen-Omni dan Qwen-OCR

    A: Model-model ini tidak dapat dikonfigurasi langsung di Dify. Anda dapat mengintegrasikannya menggunakan node HTTP dalam Chatflow atau workflow. Untuk detail integrasi, lihat 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 melakukan generasi teks-ke-gambar dan teks-ke-video menggunakan node dalam Chatflow atau workflow Dify. Ikuti langkah-langkah berikut:

    1. Unduh dan Impor Templat Workflow

      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. Konfigurasi Variabel Lingkungan

      Di halaman workflow, temukan ikon variabel lingkungan image.png, lalu ubah nilai DASHSCOPE_API_KEY menjadi kunci API Anda.

    3. Uji Output

      Klik tombol Run untuk menghasilkan output. Misalnya, memasukkan "a small cat" dalam workflow teks-ke-gambar akan menghasilkan gambar.

      Workflow 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.