> ## Documentation Index > Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt > Use this file to discover all available pages before exploring further. # Menggunakan APIMart di Dify > Panduan lengkap untuk mengonfigurasi dan menggunakan layanan API APIMart di platform LLMOps Dify. Panduan ini membantu Anda menyiapkan API APIMart di Dify untuk membangun aplikasi AI yang kuat. ## Prasyarat Sebelum memulai, pastikan: 1. **Akun Dify sudah terdaftar** Kunjungi [situs resmi Dify](https://dify.ai/) untuk mendaftar akun, lalu pilih versi cloud atau self-hosted 2. **API Key APIMart sudah diperoleh** Masuk ke [APIMart Console](https://apimart.ai/keys) untuk mendapatkan API key Anda (diawali dengan `sk-`) **Tips:** Jika Anda belum memiliki akun APIMart, daftar terlebih dahulu di [APIMart](https://apimart.ai) dan dapatkan API key. ## Langkah 1: Masuk ke Dify dan Buka Pengaturan ### 1.1 Akses Platform Dify * **Versi Cloud:** Kunjungi [https://cloud.dify.ai](https://cloud.dify.ai) lalu masuk * **Versi Self-hosted:** Kunjungi alamat deployment Dify Anda Antarmuka utama Dify *Antarmuka utama Dify yang menampilkan daftar aplikasi dan tombol buat aplikasi* ### 1.2 Buka Pengaturan Model 1. Klik **ikon avatar** di sudut kanan atas 2. Pilih **Settings** 3. Pilih **Model Provider** pada menu kiri Halaman pengaturan penyedia model *Temukan opsi "Model Provider" pada menu kiri* **Catatan:** Dify mendukung konfigurasi beberapa penyedia model. Anda dapat menggunakan APIMart bersama penyedia lain. ## Langkah 2: Tambahkan Penyedia Model APIMart **Metode Konfigurasi:** Ada dua cara untuk mengonfigurasi APIMart di Dify: **Metode 1 (Direkomendasikan):** Gunakan fitur Custom API pada penyedia OpenAI * Pada pengaturan penyedia OpenAI, ubah langsung Base URL menjadi `https://api.apimart.ai/v1` * Masukkan API Key APIMart Anda * Konfigurasi lebih cepat dan sederhana **Metode 2:** Tambahkan sebagai penyedia model kustom (metode dalam panduan ini) * Lebih fleksibel dan dapat mengelola penyedia APIMart secara terpisah * Praktis jika menggunakan beberapa penyedia API sekaligus Kedua metode memiliki fungsi yang sama. Pilih sesuai preferensi Anda. ### 2.1 Pilih Metode Konfigurasi #### Metode 1: Gunakan OpenAI Custom API (Direkomendasikan) 1. Temukan penyedia **OpenAI** pada halaman Model Provider 2. Klik tombol **Configure** atau **Settings** 3. Pada halaman konfigurasi: * **API Key**: Masukkan API key APIMart Anda (`sk-xxxxxxxxxxxx`) * **API Base URL** atau **Base URL**: Masukkan `https://api.apimart.ai/v1` 4. Klik **Save** Konfigurasi OpenAI Custom API Konfigurasi OpenAI Custom API *Konfigurasikan API Key dan Base URL APIMart pada penyedia OpenAI* 5. Setelah konfigurasi selesai, kembali ke halaman penyedia OpenAI dan lihat **Model List** 6. Pada daftar model, temukan model yang Anda butuhkan (misalnya `gpt-4o`, `gpt-4o-mini`, `chatgpt-4o-latest`, dan lainnya) 7. Klik **switch** di sisi kanan model untuk mengaktifkannya (warna biru berarti aktif) Daftar model OpenAI *Aktifkan model yang Anda butuhkan pada daftar model OpenAI* **Penting:** Aktifkan hanya model yang benar-benar didukung oleh APIMart! Meskipun daftar model OpenAI di Dify menampilkan banyak model, hanya model yang didukung APIMart yang akan berfungsi dengan benar. Mengaktifkan model yang tidak didukung akan menyebabkan panggilan API gagal. Lihat [Dokumentasi API APIMart](https://docs.apimart.ai) untuk daftar lengkap model yang didukung. **Model yang didukung dan direkomendasikan APIMart:** **Seri GPT:** * `gpt-5` / `gpt-5-chat-latest` - model seri GPT-5 * `chatgpt-4o-latest` / `gpt-4o` - model GPT-4o terbaru * `gpt-4o-mini` - versi cepat dan ekonomis * `gpt-4.1` / `gpt-4.1-mini` - seri GPT-4.1 **Seri Claude:** * `claude-sonnet-4-5-20250929` - Claude Sonnet 4.5 * `claude-haiku-4-5-20251001` - Claude Haiku 4.5 **Seri Gemini:** * `gemini-2.0-flash-exp` - Google Gemini 2.0 Flash Anda dapat mengaktifkan beberapa model sekaligus dan beralih secara fleksibel di dalam aplikasi. Setelah selesai, Anda dapat langsung menggunakannya. Lanjutkan ke **Langkah 3**. #### Metode 2: Tambahkan Penyedia Model Kustom Pada halaman Model Provider: 1. Gulir ke bagian **Custom Model** 2. Klik tombol **+ Add Model** Bagian model kustom *Gulir ke bagian model kustom dan klik tombol "+ Add Model"* ### 2.2 Konfigurasikan Penyedia APIMart Pada dialog konfigurasi, isi informasi berikut: | Kolom | Nilai | | ----------------------- | ---------------------------------------------------------------------------------------------------------- | | **Model Name** | `APIMart` atau nama kustom | | **Model Type** | Pilih `LLM` (Large Language Model) | | **API Key** | API key APIMart Anda (`sk-xxxxxxxxxxxx`) | | **API endpoint URL** | `https://api.apimart.ai/v1` | | **Endpoint model name** | Masukkan nama model tertentu (misalnya `gpt-4o`, `gpt-4o-mini`, `claude-sonnet-4-5-20250929`, dan lainnya) | Dialog tambah penyedia *Isi konfigurasi penyedia APIMart* **Penting:** * Base URL harus menyertakan akhiran `/v1`: `https://api.apimart.ai/v1` * API Key harus diperoleh dari konsol APIMart dan diawali dengan `sk-` * Pastikan API key Anda memiliki saldo yang cukup ### 2.3 Tambahkan Model Lainnya (Opsional) Untuk menambahkan model lainnya, ulangi langkah di atas: 1. Di bagian model kustom, klik lagi tombol **+ Add Model** 2. Isi informasi konfigurasi untuk model lain 3. Klik Save *Ulangi langkah tambah model untuk mengonfigurasi beberapa model berbeda* **Model yang Direkomendasikan untuk Ditambahkan:** #### Seri GPT-4/5 | ID Model | Nama Model | Panjang Konteks | Kasus Penggunaan | | ------------- | ----------- | --------------- | --------------------------------------- | | `gpt-5` | GPT-5 | 128,000 | Tugas kompleks, pemrosesan teks panjang | | `gpt-4o` | GPT-4o | 128,000 | Chat berkualitas tinggi, pembuatan kode | | `gpt-4o-mini` | GPT-4o Mini | 128,000 | Respons cepat, hemat biaya | #### Seri Claude | ID Model | Nama Model | Panjang Konteks | Kasus Penggunaan | | ---------------------------- | ----------------- | --------------- | --------------------------------- | | `claude-sonnet-4-5-20250929` | Claude Sonnet 4.5 | 200,000 | Penalaran kompleks, analisis kode | | `claude-haiku-4-5-20251001` | Claude Haiku 4.5 | 200,000 | Respons cepat, tugas sederhana | #### Seri Gemini | ID Model | Nama Model | Panjang Konteks | Kasus Penggunaan | | ---------------------- | ---------------- | --------------- | ------------------------------ | | `gemini-2.0-flash-exp` | Gemini 2.0 Flash | 32,000 | Multimodal, aplikasi real-time | **Rekomendasi Performa:** * 💰 **Hemat biaya:** `gpt-4o-mini`, `claude-haiku-4-5-20251001` * 🚀 **Performa tinggi:** `gpt-5`, `gpt-4o`, `claude-sonnet-4-5-20250929` * ⚡ **Respons cepat:** `gemini-2.0-flash-exp`, `gpt-4o-mini` ## Langkah 3: Gunakan Model APIMart di Aplikasi ### 3.1 Buat Aplikasi Baru 1. Kembali ke beranda Dify 2. Klik tombol **Create App** 3. Pilih jenis aplikasi: * **Chatbot** - aplikasi percakapan * **Text Generator** - aplikasi pembuatan teks * **Agent** - agen cerdas * **Workflow** - aplikasi alur kerja kompleks Buat aplikasi *Pilih jenis aplikasi untuk membuat aplikasi baru* ### 3.2 Pilih Model APIMart Pada halaman orkestrasi aplikasi: 1. Temukan area **Model Settings** 2. Klik dropdown **Select Model** 3. Pilih penyedia **APIMart** 4. Pilih model yang telah Anda konfigurasi (misalnya `gpt-4o`) Pilih model APIMart *Pilih model dari penyedia APIMart di dalam aplikasi* ### 3.3 Konfigurasikan Parameter Model Sesuaikan parameter model sesuai kebutuhan: | Parameter | Deskripsi | Nilai yang Direkomendasikan | | --------------------- | ------------------------------------------ | ----------------------------- | | **Temperature** | Mengontrol tingkat keacakan keluaran | 0.7 (kreatif) / 0.3 (presisi) | | **Max Tokens** | Panjang keluaran maksimum | 2000-4000 | | **Top P** | Parameter nucleus sampling | 0.9 | | **Presence Penalty** | Mengurangi pengulangan | 0.0-0.5 | | **Frequency Penalty** | Mengurangi kata yang terlalu sering muncul | 0.0-0.5 | Konfigurasikan parameter model *Sesuaikan parameter model berdasarkan kebutuhan aplikasi* ## Langkah 4: Bangun dan Uji Aplikasi ### 4.1 Tambahkan Prompt Pada halaman orkestrasi aplikasi: 1. Tulis prompt di area **System Prompt** 2. Gunakan variabel agar aplikasi lebih dinamis: * `{{variable_name}}` - variabel input pengguna * `{{context}}` - konteks basis pengetahuan **Contoh Prompt:** ``` You are a professional customer service assistant, skilled at answering product questions. Product Information: {{product_info}} Please provide accurate and friendly answers based on user questions. If unsure, honestly inform the user. User Question: {{user_question}} ``` Editor prompt *Tulis dan konfigurasikan prompt di editor prompt* ### 4.2 Tambahkan Basis Pengetahuan (Opsional) Jika Anda membutuhkan kemampuan RAG (Retrieval Augmented Generation): 1. Klik **Knowledge Base** pada menu kiri 2. Buat basis pengetahuan baru dan unggah dokumen 3. Hubungkan basis pengetahuan pada halaman orkestrasi aplikasi 4. Konfigurasikan parameter retrieval ### 4.3 Uji Aplikasi 1. Masukkan pertanyaan uji di panel **Preview** di sebelah kanan 2. Tinjau efektivitas respons AI 3. Sesuaikan prompt dan parameter sesuai kebutuhan 4. Ulangi pengujian hingga hasilnya memuaskan Pratinjau dan pengujian aplikasi *Uji efektivitas aplikasi di panel pratinjau* ### 4.4 Publikasikan Aplikasi Setelah pengujian: 1. Klik tombol **Publish** di kanan atas 2. Pilih metode publikasi: * **API Call** - integrasi melalui API * **Embed in Website** - buat kode sematan * **Public Link** - buat tautan berbagi Opsi publikasi aplikasi *Pilih metode publikasi yang sesuai* ## Langkah 5: Pantau dan Optimalkan ### 5.1 Lihat Log Aplikasi Pada halaman detail aplikasi: 1. Klik tab **Logs** 2. Lihat semua catatan percakapan 3. Analisis pertanyaan pengguna dan respons AI 4. Temukan peluang perbaikan Log aplikasi *Lihat dan analisis log penggunaan aplikasi* ### 5.2 Pantau Penggunaan API Masuk ke [APIMart Console](https://apimart.ai/overview) untuk melihat: * 📊 **Statistik Panggilan API** - total panggilan, tingkat keberhasilan * 💰 **Rincian Biaya** - biaya harian/bulanan * 📈 **Tren Penggunaan** - tren perubahan penggunaan * 🔍 **Log Permintaan** - catatan permintaan terperinci ### 5.3 Optimalkan Performa Aplikasi Optimalkan berdasarkan data pemantauan: 1. **Sesuaikan Pilihan Model** * Gunakan `gpt-4o-mini` untuk tugas sederhana agar biaya lebih rendah * Gunakan `gpt-4o` atau `claude-sonnet-4-5` untuk tugas kompleks agar kualitas lebih baik 2. **Optimalkan Prompt** * Buat prompt lebih jelas dan spesifik * Tambahkan contoh untuk meningkatkan efektivitas * Gunakan chain-of-thought untuk penalaran yang lebih baik 3. **Konfigurasikan Caching** * Aktifkan caching untuk pertanyaan serupa * Kurangi biaya panggilan API ## Fitur Lanjutan ### Menggunakan Orkestrasi Workflow Fitur workflow Dify memungkinkan Anda untuk: 1. **Cabang Bersyarat** - menjalankan logika berbeda berdasarkan kondisi 2. **Kolaborasi Multi-model** - menggabungkan keunggulan beberapa model 3. **Panggilan Tool Eksternal** - memanggil API, database, dan sumber eksternal lainnya 4. **Penerusan Variabel** - meneruskan data antar-node ### Mengonfigurasi Kemampuan Agent Bangun agent cerdas dengan model APIMart: 1. **Tool Calling** - memungkinkan AI memanggil tool eksternal 2. **Manajemen Memori** - mempertahankan memori percakapan jangka panjang 3. **Pengambilan Keputusan Otonom** - AI merencanakan langkah eksekusi secara mandiri ### Aplikasi Multimodal Manfaatkan kemampuan multimodal APIMart: 1. **Pemahaman Gambar** - gunakan `gpt-4o` atau `claude-3` untuk memproses gambar 2. **Pembuatan Gambar** - integrasikan API pembuatan gambar APIMart 3. **Pemrosesan Suara** - integrasikan layanan TTS dan STT ## FAQ ### Q1: Tidak dapat terhubung ke layanan APIMart? **Solusi:** 1. **Periksa Base URL**: * Pastikan nilainya `https://api.apimart.ai/v1` (termasuk `/v1`) * Jangan menambahkan path tambahan atau menghilangkan `/v1` 2. **Verifikasi API Key**: * Pastikan API Key diawali dengan `sk-` * Periksa apakah key valid di [APIMart Console](https://apimart.ai/keys) 3. **Periksa Koneksi Jaringan**: * Pastikan server dapat mengakses `https://api.apimart.ai` * Untuk versi self-hosted, pastikan konektivitas jaringan server tersedia ### Q2: Respons model lambat? **Solusi:** 1. **Beralih ke Model yang Lebih Cepat**: * Gunakan `gpt-4o-mini` sebagai pengganti `gpt-4o` * Gunakan `gemini-2.0-flash-exp` untuk respons yang lebih cepat 2. **Optimalkan Panjang Prompt**: * Kurangi konteks yang tidak diperlukan * Sederhanakan deskripsi prompt 3. **Sesuaikan Retrieval Basis Pengetahuan**: * Kurangi jumlah dokumen yang diambil * Naikkan ambang kemiripan ### Q3: Panggilan API gagal atau mengembalikan error? **Error umum dan solusinya:** | Pesan Error | Penyebab | Solusi | | --------------------------- | ------------------------------------ | ------------------------------------------------------------------- | | `401 Unauthorized` | API Key tidak valid atau kedaluwarsa | Dapatkan ulang API Key dan perbarui konfigurasi | | `429 Too Many Requests` | Batas laju permintaan terlampaui | Sesuaikan pengaturan konkurensi aplikasi atau tunggu lalu coba lagi | | `500 Internal Server Error` | Masalah server sementara | Tunggu beberapa menit lalu coba lagi | | `insufficient_quota` | Saldo akun tidak cukup | Isi saldo di konsol | | `context_length_exceeded` | Input melebihi panjang konteks | Kurangi panjang input atau gunakan model dengan konteks lebih besar | ### Q4: Bagaimana mengurangi biaya penggunaan API? **Saran optimasi biaya:** 1. **Pemilihan Model**: * Gunakan `gpt-4o-mini` untuk tugas sederhana (biayanya hanya sekitar 1/10 dari `gpt-4o`) * Pertimbangkan model yang lebih ekonomis untuk tugas batch 2. **Aktifkan Caching**: * Kembalikan hasil cache untuk pertanyaan yang sama * Konfigurasikan pencocokan kemiripan di Dify 3. **Optimalkan Panjang Keluaran**: * Tetapkan Max Tokens secara wajar * Hindari menghasilkan respons yang terlalu panjang 4. **Gunakan Output Streaming**: * Tingkatkan pengalaman pengguna tanpa menambah biaya ### Q5: Bagaimana menangani data sensitif? **Rekomendasi keamanan data:** 1. **Gunakan Environment Variables**: * Jangan hardcode API Key di dalam kode * Gunakan fitur environment variable Dify 2. **Konfigurasikan Kontrol Akses**: * Atur izin akses aplikasi * Aktifkan autentikasi untuk panggilan API 3. **Audit Log**: * Periksa log aplikasi secara berkala * Pantau pola akses yang tidak normal ## Praktik Terbaik ### 1. Prompt Engineering **Prompt Terstruktur:** ``` # Role Definition You are a professional [role description] # Task Objective You need to help users [task description] # Output Requirements - Requirement 1 - Requirement 2 - Requirement 3 # Input Information {{user_input}} ``` ### 2. Manajemen Basis Pengetahuan * **Strategi Chunking**: Tetapkan ukuran chunk dokumen yang wajar (direkomendasikan 500-1000 karakter) * **Penandaan Metadata**: Tambahkan metadata pada dokumen agar lebih mudah diambil * **Pembaruan Berkala**: Jaga konten basis pengetahuan tetap mutakhir ### 3. Penanganan Error * **Pesan yang Ramah**: Berikan pesan error yang jelas kepada pengguna * **Strategi Fallback**: Beralih ke model cadangan saat model utama gagal * **Mekanisme Retry**: Coba ulang otomatis untuk error sementara ### 4. Pemantauan Performa * **Atur Peringatan**: Beri peringatan untuk saldo rendah dan tingkat error tinggi * **Analisis Berkala**: Analisis data penggunaan mingguan/bulanan * **Optimasi Berkelanjutan**: Sesuaikan konfigurasi berdasarkan data ## Contoh Kasus Penggunaan ### 1. Layanan Pelanggan Cerdas **Konfigurasi Aplikasi:** * Model: `gpt-4o-mini` (hemat biaya) * Basis Pengetahuan: dokumentasi produk, FAQ * Fitur: jawab otomatis pertanyaan umum, eskalasi masalah kompleks ke manusia ### 2. Asisten Pembuatan Konten **Konfigurasi Aplikasi:** * Model: `gpt-4o` atau `claude-sonnet-4-5` (kualitas tinggi) * Fitur: pembuatan artikel, penulisan ulang, penyempurnaan * Parameter: Temperature=0.8 (meningkatkan kreativitas) ### 3. Asisten Kode **Konfigurasi Aplikasi:** * Model: `claude-sonnet-4-5` (sangat baik untuk kode) * Fitur: pembuatan kode, penjelasan, debugging * Basis Pengetahuan: dokumentasi proyek, dokumentasi API ### 4. Asisten Analisis Data **Konfigurasi Aplikasi:** * Model: `gpt-4o` (kemampuan penalaran kuat) * Tool: eksekusi kode Python, visualisasi data * Fitur: analisis data, pembuatan laporan ## Fitur Dengan Dify + APIMart, Anda dapat: * 🤖 **Membangun Aplikasi AI dengan Cepat** - buat aplikasi AI yang kuat tanpa coding * 📚 **Peningkatan Basis Pengetahuan** - teknologi RAG memungkinkan AI menjawab berdasarkan data Anda * 🔧 **Workflow yang Fleksibel** - orkestrasi logika AI kompleks secara visual * 🎯 **Manajemen Prompt yang Presisi** - version control dan A/B testing * 📊 **Pemantauan & Analitik Lengkap** - pahami penggunaan dan performa aplikasi * 🔌 **Beragam Metode Integrasi** - API, sematan, WebApp, dan lainnya * 👥 **Kolaborasi Tim** - mendukung pengembangan kolaboratif multi-pengguna * 🌐 **Dukungan Multi-model** - beralih secara fleksibel antar-model AI ## Dukungan & Bantuan Jika Anda mengalami masalah: * 📚 [Dokumentasi APIMart](https://docs.apimart.ai) * 📚 [Dokumentasi Resmi Dify](https://docs.dify.ai) * 💬 [Komunitas Discord](https://discord.gg/V8zqssyZ5c) * 🐦 [Twitter @APIMart\_](https://x.com/APIMart_) * 📧 Dukungan Teknis: [zhihong@apimart.ai](mailto:zhihong@apimart.ai) *** Daftar APIMart sekarang, dapatkan API key Anda, dan bangun aplikasi AI yang kuat di Dify!