Cara Menambahkan OpenAI, Claude, Gemini, dan DeepSeek ke Dify

Apa yang Akan Anda Bangun

Layanan API mana yang memungkinkan Anda menambahkan lebih banyak model AI ke Dify tanpa menyiapkan setiap penyedia secara terpisah? CometAPI adalah salah satu opsi praktis. Instal plugin model Dify CometAPI sekali, simpan satu kunci CometAPI, dan gunakan model dari OpenAI, Anthropic, Google, dan DeepSeek dalam satu workspace Dify yang sama.

Satu Kunci Tidak Berarti Satu Konfigurasi Model: CometAPI memusatkan autentikasi dan akses API, tetapi Dify tetap perlu mengetahui model mana yang harus dipanggil setiap node LLM. Karena itu, Anda dapat mengonfigurasi beberapa ID model di bawah koneksi penyedia yang sama.

Di akhir panduan ini, Anda akan memiliki empat model teks yang tersedia untuk Dify di bawah satu koneksi penyedia. Anda juga akan memiliki sebuah smoke test Python kecil yang menggunakan endpoint dan key yang sama di luar Dify, sehingga memudahkan memisahkan masalah konfigurasi Dify dari masalah API.

Setelah koneksi penyedia disimpan, tambahkan atau aktifkan setiap ID model sebagai konfigurasi yang dapat dipilih secara terpisah. Ini menjaga kapabilitas, batasan, dan keputusan routing spesifik model tetap terlihat sementara koneksi autentikasi dan penagihan tetap dibagikan.

Sebelum Anda Mulai

Anda memerlukan workspace Dify tempat Anda dapat menginstal plugin model, sebuah kunci API CometAPI, dan ID model terbaru. Simpan kunci di credential store Dify atau secret sisi server; jangan menaruhnya di repositori publik, bundel browser, tangkapan layar, atau ekspor workflow yang dibagikan.

Base URL yang kompatibel dengan OpenAI adalah https://api.cometapi.com/v1. Plugin Dify CometAPI menetapkan endpoint ini secara internal. Jika Anda menggunakan penyedia generik yang kompatibel dengan OpenAI API milik Dify, masukkan base URL yang sama secara manual.

Bisakah Anda Menambahkan Beberapa Model AI ke Dify dengan Satu Kunci API?

Ya. Koneksi penyedia CometAPI memungkinkan Dify menggunakan satu kredensial untuk model yang didukung dari OpenAI, Anthropic, Google, DeepSeek, dan penyedia lainnya. Anda tetap mengonfigurasi setiap ID model secara terpisah agar setiap node LLM mengetahui rute mana yang harus dipanggil, tetapi Anda tidak perlu mengelola kredensial upstream dan akun penagihan yang berbeda untuk setiap keluarga model.

Mengapa Menggunakan CometAPI Alih-alih Menghubungkan Setiap Penyedia Secara Langsung?

CometAPI mengurangi overhead integrasi dengan memberikan beban kerja chat yang kompatibel satu base URL, satu kunci API, dan satu akun penggunaan. Itu mempermudah evaluasi dan peralihan model di dalam Dify sambil menjaga pilihan spesifik model tetap terlihat. Koneksi penyedia langsung tetap mungkin lebih disukai ketika Anda memerlukan fitur khusus penyedia, kontrak, deployment regional, atau dukungan tertentu, jadi uji kapabilitas model yang tepat yang diperlukan oleh workflow Anda.

Model Apa yang Dapat Anda Tambahkan ke Dify?

ID terkini dan tanggal publikasi CometAPI di atas telah diperiksa terhadap public catalog API pada 26 Agustus 2026. Gunakan setiap halaman model CometAPI yang ditautkan sebagai sumber harga dinamis alih-alih menyalin tarif yang mungkin sudah usang. Ketersediaan, modalitas, dan dukungan plugin Dify juga dapat berubah, jadi konfirmasikan model yang tepat di akun Anda sebelum deployment.

Cara Menghubungkan CometAPI ke Dify

Langkah 1 — Instal plugin model CometAPI

Buka bagian Marketplace atau Plugins di Dify dan cari CometAPI. Instal plugin penyedia model CometAPI. Label navigasi yang tepat dapat bervariasi antara Dify Cloud dan versi self-hosted, jadi gunakan layar konfigurasi plugin saat ini alih-alih mengandalkan jalur menu tetap.

Langkah 2 — Konfigurasikan penyedia CometAPI

Buka layar konfigurasi plugin CometAPI saat ini, tempelkan kunci CometAPI Anda, dan simpan kredensial penyedia. Dify mungkin memvalidasinya dengan permintaan model kecil. Plugin merutekan beban kerja chat yang kompatibel melalui https://api.cometapi.com/v1, jadi Anda tidak perlu kredensial OpenAI, Anthropic, Google, dan DeepSeek terpisah.

Jika deployment Dify Anda tidak dapat menginstal plugin CometAPI, instal penyedia model resmi OpenAI-API-compatible. Tambahkan setiap model sebagai LLM dalam mode Chat, gunakan kembali kunci CometAPI yang sama, dan setel API Base URL ke https://api.cometapi.com/v1. Jalur fallback ini meminta Anda membuat satu entri kustom per model, tetapi tetap menghindari akun penyedia terpisah.

Langkah 3 — Tambahkan empat ID model

Kembali ke penyedia CometAPI dan cari empat ID tersebut dalam daftar model. Jika sebuah ID sudah didefinisikan sebelumnya, aktifkan. Jika belum terlihat di versi plugin yang Anda instal, pilih opsi model kustom milik penyedia dan masukkan ID terkini persis seperti pada tabel di atas. Biarkan Completion mode di Chat.

Saat Dify meminta ukuran konteks pada model kustom, gunakan nilai yang telah diperiksa alih-alih default perkiraan. Untuk sakelar multimodal, aktifkan hanya kapabilitas yang ditunjukkan di katalog live. Sebuah model dapat mendukung Chat Completions tanpa mendukung images, tools, structured output, atau reasoning controls dengan cara yang sama seperti model lain.

Langkah 4 — Pilih model di aplikasi Dify Anda

Buka Chatflow, Workflow, Agent, atau chatbot di Dify Studio. Tambahkan node LLM, pilih CometAPI sebagai penyedia, dan pilih salah satu ID model yang dikonfigurasi. Gunakan prompt singkat seperti “Balas dengan keluarga model dalam satu kalimat,” lalu jalankan node. Ulangi dengan tiga model lainnya. Hanya ID model yang dipilih yang berubah; kredensial penyedia tetap sama.

Cara Menguji Koneksi dengan Python

Gunakan smoke test mandiri ini untuk memeriksa empat rute yang sama sebelum melibatkan Dify. Instal OpenAI Python SDK, simpan COMETAPI_KEY di environment Anda, dan jalankan skrip dari mesin tepercaya. Hasil yang berhasil memverifikasi key, endpoint, dan ID model terkini; ini tidak menggantikan pengujian di dalam workflow Dify yang sebenarnya.

import osfrom openai import OpenAI​MODELS = {    "OpenAI": "gpt-5.6",    "Claude": "claude-opus-5",    "Gemini": "gemini-3.7-flash",    "DeepSeek": "deepseek-v4-flash",}​client = OpenAI(    api_key=os.environ["COMETAPI_KEY"],    base_url="https://api.cometapi.com/v1",    timeout=30.0,    max_retries=2,)​for family, model in MODELS.items():    try:        response = client.chat.completions.create(            model=model,            messages=[                {"role": "user", "content": "Reply with one short sentence."}            ],        )        text = response.choices[0].message.content or ""        print(f"{family}: OK | {response.model} | {text[:80]}")    except Exception as error:        print(f"{family}: ERROR | {type(error).__name__} | {error}")

Simpan test ini di luar workflow Dify Anda. Tugasnya adalah memverifikasi key, endpoint, dan ID model. Setelah sebuah model berhasil di sini, kegagalan di Dify lebih mungkin berasal dari konfigurasi plugin, pengaturan kapabilitas model, atau workflow itu sendiri.

Cara Memverifikasi Ketersediaan Model Sebelum Deployment

Anda dapat memverifikasi ketersediaan model melalui direktori model CometAPI atau Models API saat ini sebelum deployment. Konfirmasikan bahwa ID model yang tepat muncul di akun Anda, lalu jalankan permintaan autentikasi kecil sebelum menambahkannya ke workflow produksi Dify.

Dengan key Anda sendiri, panggilan non-streaming yang berhasil mengembalikan sebuah objek Chat Completions. Redaksi yang dihasilkan akan bervariasi, tetapi respons harus berisi field berikut:

{  "id": "chatcmpl-...",  "object": "chat.completion",  "model": "the-routed-model-id",  "choices": [    {      "index": 0,      "message": {        "role": "assistant",        "content": "..."      },      "finish_reason": "stop"    }  ],  "usage": {    "prompt_tokens": 0,    "completion_tokens": 0,    "total_tokens": 0  }}

Di Dify, sinyal sukses yang setara adalah node LLM yang selesai dengan teks di panel output. Periksa run log Dify untuk model yang dipilih, waktu yang dihabiskan, penggunaan token, dan setiap error penyedia yang dinormalisasi.

Cara Memilih Model yang Tepat untuk Dify

Mulailah dari beban kerja alih-alih nama penyedia. Gunakan model frontier untuk penalaran sulit, pekerjaan basis kode besar, atau jawaban bernilai tinggi; pilih model yang lebih cepat untuk chat interaktif dan langkah workflow berulang; dan gunakan model teks berbiaya lebih rendah untuk klasifikasi, ekstraksi, atau tugas terbatas lainnya. Bandingkan model dengan set prompt yang sama dan catat kualitas jawaban, latensi, penggunaan token, perilaku tool, dan biaya per run yang berhasil. Juga konfirmasikan bahwa rute yang dipilih mendukung setiap input dan fitur yang diperlukan. Koneksi CometAPI bersama menyederhanakan peralihan, tetapi tidak membuat batas konteks, input multimodal, tools, output terstruktur, atau kontrol penalaran menjadi identik di seluruh model.

Skenario Umum Troubleshooting & Solusi

Dify menolak kredensial dengan 401. Salin ulang key dari dashboard CometAPI dan hapus spasi di awal atau akhir. Jangan sertakan kata Bearer di field API Key milik Dify; plugin membangun header otorisasi.

Penyedia generik mengembalikan 404 atau HTML. Gunakan base URL lengkap https://api.cometapi.com/v1. Menghilangkan /v1 atau menambahkan /chat/completions ke base URL Dify dapat menghasilkan path final yang salah.

Model tidak muncul di Dify. Perbarui plugin CometAPI, lalu bandingkan ID dengan katalog live. Jika ID terkini belum didefinisikan, tambahkan sebagai model kustom di bawah penyedia CometAPI yang sama. Jangan mengganti nama model yang terlihat mirip.

Permintaan teks berhasil tetapi images atau tools gagal. Kompatibilitas OpenAI menjelaskan permukaan permintaan, bukan perilaku model yang identik. Periksa ulang modalitas yang terdaftar untuk model dan pengaturan vision, pemanggilan tools, output terstruktur, serta penalaran pada plugin.

Permintaan melebihi jendela konteks. Konfirmasikan ukuran konteks model kustom di Dify, perpendek dokumen yang diambil dan riwayat percakapan, serta sisakan ruang untuk output. Konteks katalog yang lebih besar tidak menghapus batas workflow Dify atau aturan token spesifik penyedia.

Anda menerima 429 atau error 5xx intermiten. Retry error 429, timeout, dan server sementara dengan exponential backoff dan jitter. Jangan otomatis retry error autentikasi, invalid-model, atau permintaan yang malformed.

Catatan Produksi

Simpan secret di sisi server. Gunakan kunci CometAPI terpisah untuk pengembangan dan produksi, tetapkan kuota yang masuk akal, rotasi key yang terekspos, dan hindari mengekspor kredensial nyata bersama aplikasi Dify.

Pin ID model yang sudah diuji. Jangan mengganti model secara diam-diam hanya karena nama yang lebih baru muncul di katalog. Kapabilitas, latensi, gaya output, dan harga dapat berubah antar versi bahkan ketika penyedianya sama.

Ukur per rute. Catat ID model, latensi, penggunaan token, kode error, dan versi aplikasi Dify untuk setiap panggilan produksi. Ini memungkinkan perbandingan model dan investigasi perubahan biaya tanpa bergantung pada impresi.

Rancang fallback berdasarkan kapabilitas. Gunakan model berbiaya lebih rendah untuk trafik rutin dan model yang lebih kuat untuk eskalasi, tetapi hanya pasangkan model yang mendukung input dan tools yang sama. Retry kegagalan sementara sebelum beralih model, batasi total anggaran latensi, dan uji setiap rute fallback. Lihat panduan model fallback CometAPI untuk pola produksi.

Periksa ulang harga sebelum peluncuran. Tarif dalam artikel ini adalah snapshot bertanggal, bukan kontrak. Tinjau panduan harga dan direktori model live sebelum menetapkan anggaran atau memublikasikan klaim biaya.

FAQ

Bagaimana Cara Menambahkan OpenAI ke Dify Melalui CometAPI?

Instal plugin penyedia model CometAPI, simpan kunci CometAPI Anda, dan tambahkan gpt-5.6 sebagai model LLM yang dapat dipilih. Pilih mode Chat saat Dify meminta mode completion, lalu jalankan prompt teks singkat sebelum mengaktifkan model di workflow produksi. Katalog CometAPI saat ini mencantumkan rute untuk beban kerja chat dan Responses yang kompatibel, tetapi dukungan plugin Dify dapat bervariasi menurut versi. Jika ID belum didefinisikan, perbarui plugin atau gunakan opsi model kustomnya. Biarkan kredensial penyedia bersama tetap tidak berubah dan validasi input image, pemanggilan tools, output terstruktur, dan pengaturan penalaran secara terpisah sebelum mengandalkannya.

Bagaimana Cara Menambahkan Claude ke Dify Melalui CometAPI?

Di bawah koneksi penyedia CometAPI yang sama, tambahkan claude-opus-5 sebagai model LLM terpisah dan pilih itu di node Dify yang membutuhkan Claude. Katalog CometAPI saat ini mendokumentasikan rute Anthropic Messages dan rute chat yang kompatibel dengan OpenAI untuk model ini. Dify tetap membutuhkan entri model sendiri karena ID Claude, input yang didukung, batas token, dan perilaku berbeda dari rute OpenAI. Uji satu respons sederhana dan satu tugas panjang atau berbantuan tool yang representatif, lalu inspeksi run log Dify untuk model aktual, latensi, penggunaan token, dan error yang dinormalisasi sebelum menjadikannya default.

Bagaimana Cara Menambahkan Gemini ke Dify Melalui CometAPI?

Tambahkan gemini-3.7-flash di bawah penyedia CometAPI yang ada, lalu pilih entri itu di node LLM Dify yang relevan. CometAPI saat ini mencantumkan rute native Gemini generating-content dan rute chat yang kompatibel dengan OpenAI. Untuk workflow chat Dify dasar, mulailah dengan teks saja dan konfirmasikan run yang berhasil sebelum menguji input images, PDF, audio, atau video. Modalitas tersebut dapat bergantung pada versi plugin dan konfigurasi node meskipun katalog model mencantumkannya. Pertahankan Gemini sebagai konfigurasi model yang berbeda agar Anda dapat menetapkan batas yang sesuai dan membandingkan kecepatan, kualitas, dan biaya dengan rute lainnya.

Bagaimana Cara Menambahkan DeepSeek ke Dify Melalui CometAPI?

Buat entri model Dify terpisah untuk deepseek-v4-flash sambil menggunakan kembali kredensial penyedia CometAPI yang sama. Katalog CometAPI saat ini mencantumkan rute ini untuk beban kerja chat teks-ke-teks, jadi jangan menyalin pengaturan image dari konfigurasi OpenAI, Claude, atau Gemini. Uji prompt teks singkat terlebih dahulu, diikuti oleh tugas coding atau penalaran yang benar-benar Anda rencanakan untuk dijalankan. Jika model tidak ada di Dify, perbarui plugin atau tambahkan ID terkini persis melalui opsi model kustom. Periksa ulang halaman model live untuk harga dan ketersediaan dinamis sebelum merutekan trafik produksi.

Bisakah saya menggunakan OpenAI, Claude, Gemini, dan DeepSeek dalam workflow Dify yang sama?

Ya. Setiap node LLM dapat menggunakan konfigurasi penyedia/model yang berbeda. Dengan CometAPI, model yang didukung dapat berbagi kredensial penyedia yang sama sementara workflow memilih ID model yang berbeda.

Apakah satu kunci CometAPI benar-benar mencakup OpenAI, Claude, Gemini, dan DeepSeek di Dify?

Ya. Plugin model CometAPI Dify menyimpan satu kredensial penyedia dan menggunakannya untuk model yang didukung di seluruh keluarga tersebut. Anda tetap memilih atau menambahkan setiap ID model agar Dify mengetahui model mana yang akan dipanggil.

Apakah saya perlu memasukkan base URL CometAPI di Dify?

Tidak saat Anda menggunakan plugin CometAPI khusus; plugin menetapkan https://api.cometapi.com/v1 secara internal. Masukkan base URL itu secara manual hanya saat Anda menggunakan penyedia model generik yang kompatibel dengan OpenAI API milik Dify.

Apakah Dify mendukung Claude melalui API yang kompatibel dengan OpenAI?

Dify dapat bekerja dengan penyedia model yang kompatibel dengan OpenAI, tetapi kompatibilitas tidak membuat perilaku API Claude identik dengan OpenAI. Validasi parameter dan kapabilitas yang didukung model sebelum mengaktifkan tools, output terstruktur, vision, atau fitur spesifik penalaran.

Bisakah saya menggunakan pengaturan Dify yang sama untuk setiap model?

Tidak. Endpoint dan key dapat dibagikan, tetapi batas konteks, modalitas, dukungan tools, kontrol penalaran, latensi, dan harga tetap spesifik per model. Perlakukan setiap pemetaan model sebagai konfigurasi yang sudah diuji.

Model mana yang harus saya jadikan default?

Pilih setelah menguji prompt Anda sendiri. Model berbiaya rendah dapat menangani klasifikasi atau penulisan ulang rutin, sementara model yang lebih kuat dapat menangani penalaran kompleks atau respons bernilai lebih tinggi. Hindari klaim “terbaik” universal tanpa data beban kerja.

Kesimpulan

CometAPI memungkinkan sebuah workspace Dify menggunakan OpenAI, Claude, Gemini, dan DeepSeek melalui satu kredensial penyedia dan satu endpoint API terpadu untuk beban kerja chat yang kompatibel. Penyiapannya singkat: instal plugin model, simpan key, petakan ID model terkini, dan uji setiap rute. Pekerjaan operasional tetap spesifik per model—kapabilitas, konteks, harga, dan perilaku fallback harus diverifikasi, bukan diasumsikan.