# Cara mengatur model kustom di WorkBuddy > Konfigurasikan model kustom WorkBuddy dalam tiga langkah: buka Tambahkan model, pilih Kustom, masukkan URL API OmniaKey, kunci, dan ID model, lalu simpan. - Canonical HTML: https://omniakey.com/id/blog/workbuddy-custom-model-setup - Markdown: https://omniakey.com/id/blog/workbuddy-custom-model-setup.md - Published: 2026-08-20 (updated 2026-09-21) - Author: Kiki, COO at OmniaKey - Language: id - Category: API setup - Reading time: 8 min - All posts: https://omniakey.com/blog/llms.txt --- Panduan ini menggunakan antarmuka model kustom WorkBuddy saat ini. Siapkan kunci OmniaKey API dan satu ID model yang tepat sebelum membuka WorkBuddy. > **Formulir yang sudah selesai:** pilih **Kustom**, masukkan `https://api.omniakey.com/v1`, tempelkan kunci OmniaKey API Anda, dan gunakan ID model yang tepat seperti `deepseek-v4-flash`. Formulir, detail model yang disimpan, dan pemilih model diperiksa di aplikasi macOS yang menjalankan WorkBuddy `v5.3.14`. Instruksi resmi Tencent Cloud memerlukan setidaknya `v4.22.15` untuk fitur ini. |bidang WorkBuddy|Nilai| |-|-| |Penyedia|`Custom` di bawah grup **Lainnya**| |Alamat antarmuka|`https://api.omniakey.com/v1`| |Kunci API|Kunci dibuat di OmniaKey| |Nama model|Misalnya, `deepseek-v4-flash`| ## Sebelum memulai, siapkan dua item ### Kunci OmniaKey API Masuk ke OmniaKey dan buka [halaman Kunci API](https://omniakey.com/id/dashboard/tokens): 1. Pilih **Buat kunci**. 2. Beri nama `WorkBuddy`, lalu tetapkan batas dan masa berlaku yang sesuai. 3. Buat dan segera salin kunci baru. Biarkan dialog kunci tetap terbuka hingga Anda menempelkan kredensial ke WorkBuddy. Jangan letakkan kunci di tangkapan layar, pesan obrolan, atau file publik. Akun tersebut juga memerlukan saldo atau kredit percobaan yang tersedia. Membuat kunci hanya menciptakan kredensial; itu tidak menjamin bahwa akun tersebut dapat mendanai permintaan. Kunci yang sama berfungsi di alat lain; lihat panduan [pengaturan API Cherry Studio](https://omniakey.com/id/blog/cherry-studio-api-setup), [API key kustom Cline](https://omniakey.com/id/blog/cline-custom-api-key), dan [pengaturan Claude Code](https://omniakey.com/id/blog/claude-code-setup). ### ID model yang tepat Buka [katalog model OmniaKey](https://omniakey.com/id/models), pilih model yang tersedia saat ini, dan salin ID model yang ditampilkan di halaman. Untuk tes pertama, gunakan: ```text deepseek-v4-flash ``` ID harus sama persis. Jangan memasukkan nama tampilan `DeepSeek V4 Flash`, menghapus tanda hubung, atau membuat alias yang lebih pendek. ## Langkah 1: Buka Tambahkan model Mulai WorkBuddy dan buka: ```text System Settings → Models → + Add model ``` Pada halaman Model, pilih **+ Tambahkan model** di sudut kanan atas. ![Halaman pengaturan Model WorkBuddy dengan tombol Tambahkan model di sudut kanan atas](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/01-open-model-settings.2eba6570.1000.webp) _Langkah 1: Pengaturan Sistem → Model → + Tambahkan model._ Anda juga dapat memasukkan tugas baru dari bawah: ```text Model picker → + Configure custom model ``` Jika tidak ada entri yang tersedia, perbarui WorkBuddy ke versi `v4.22.15` atau lebih baru. Instruksi Tencent Cloud saat ini memerlukan setidaknya versi ini untuk antarmukanya. ## Langkah 2: Pilih Kustom dan lengkapi empat bidang Isi formulir dari atas ke bawah. ### 1. Pilih penyedia Kustom Buka menu Penyedia dan pilih: ```text Custom ``` Di `v5.3.14`, ini muncul di bawah grup **Lainnya**. Jangan memilih OpenAI bawaan, Tencent Cloud Token Plan, atau penyedia lain karena profil tersebut tidak menggunakan alamat antarmuka OmniaKey. ![Opsi penyedia khusus di bagian bawah menu Penyedia WorkBuddy](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/02-choose-custom-provider.fabcb941.560.webp) _Langkah 2: gulir ke bagian bawah menu Penyedia dan pilih Kustom di bawah Lainnya._ ### 2. Masukkan alamat melalui `/v1` Di **Alamat antarmuka** atau **Base URL**, masukkan persis: ```text https://api.omniakey.com/v1 ``` > **Jangan salin placeholder abu-abu.** Ini menunjukkan contoh yang diakhiri dengan `/v1/chat/completions`, namun OmniaKey menggunakan Base URL `https://api.omniakey.com/v1` di bidang ini. ### 3. Tempel kunci API Tempelkan kunci yang Anda salin dari OmniaKey ke **Kunci API**. Jangan menambahkan tanda kutip, spasi, atau kata `Bearer`; masukkan hanya nilai kunci. ### 4. Masukkan nama model Di bawah **Nama model** atau **Model ID**, masukkan ID katalog yang tepat: ```text deepseek-v4-flash ``` Bentuk inti sekarang seharusnya berbunyi: ```text Provider: Custom Interface address: https://api.omniakey.com/v1 API Key: [your OmniaKey API key] Model name: deepseek-v4-flash ``` ![Formulir model kustom WorkBuddy diisi dengan alamat antarmuka OmniaKey dan nama model deepseek-v4-flash](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/03-fill-omniakey-fields.addb54d9.560.webp) _Contoh yang sudah selesai. Kunci API sengaja dikosongkan di tangkapan layar; tempelkan kunci OmniaKey Anda sendiri saat mengonfigurasi WorkBuddy._ Untuk pengujian koneksi pertama, biarkan kolom lainnya pada nilai default dan pastikan **Protokol khusus** tidak aktif. Di `v5.3.14`, formulir baru dimulai dengan Tool calling aktif, Input gambar nonaktif, Mode Penalaran nonaktif, Protokol kustom nonaktif, dan batas input dan output default penyedia. Prasetel `deepseek-v4-flash` yang terverifikasi muncul di bawah. ## Langkah 3: Simpan, pilih model, dan uji Pilih **Simpan** dan kembali ke tugas baru. Buka pemilih model di bagian bawah, temukan bagian model khusus, dan pilih `deepseek-v4-flash`. Kirim satu pesan tes singkat: ```text Reply with exactly: Connection successful ``` Respons normal mengonfirmasi empat bagian pengaturan sekaligus: 1. WorkBuddy menyimpan penyedia khusus. 2. Base URL benar. 3. Kunci API diterima dan memiliki kredit yang dapat digunakan. 4. Kuncinya dapat mengakses ID model yang dipilih. Terakhir, buka [OmniaKey Usage](https://omniakey.com/id/dashboard/usage) dan konfirmasikan bahwa panggilan tersebut muncul dengan model yang diharapkan. Ini menutup putaran verifikasi dari WorkBuddy ke OmniaKey. Jika model yang disimpan tidak segera muncul, tutup dan buka kembali alat pilih. Keluar sepenuhnya dan mulai ulang WorkBuddy jika masih tidak muncul. ## Pengaturan lanjutan yang disarankan untuk pengujian pertama Jangan mengubah beberapa kontrol kemampuan sebelum obrolan dasar berfungsi. Model kustom baru di WorkBuddy `v5.3.14` dimulai dengan: |Pilihan|Default bentuk baru| |-|-| |Tool calling|Aktif| |masukan gambar|Mati| |Modus penalaran|Mati| |Protokol khusus|Mati| |Batas masukan dan keluaran|Default penyedia| Gunakan default ini untuk memverifikasi URL, kunci, dan nama model terlebih dahulu. Kemudian sesuaikan kemampuan untuk model tersebut. ### Prasetel `deepseek-v4-flash` terverifikasi Model tersimpan dan balasan lokal yang berhasil menggunakan konfigurasi ini: |Pilihan|Pengaturan `deepseek-v4-flash`| |-|-| |Tool calling|Mati| |masukan gambar|Mati| |Modus penalaran|**Aktif**| |Hanya penalaran|Mati| |Izinkan menonaktifkan alasan|**Aktif**| |Protokol khusus|**Mati**| |Upaya penalaran standar|`Auto (use request-layer default)`| |Mendukung upaya penalaran|Biarkan Rendah, Sedang, Tinggi, Ekstra Tinggi, dan Maksimum tidak dicentang| |Batas masukan dan keluaran|Default penyedia| WorkBuddy menampilkan Penalaran saja, Izinkan penonaktifan penalaran, dan kontrol upaya setelah mode Penalaran diaktifkan. Tinggalkan upaya pada Otomatis untuk pengujian pertama. ### Kapan mengaktifkan pemanggilan alat Aktifkan **Tool calling** ketika WorkBuddy perlu membaca file, menggunakan konektor, atau melakukan tugas agen. Model tersebut juga harus mendukung pemanggilan alat terstruktur. `deepseek-v4-flash` saat ini memiliki dukungan alat di katalog OmniaKey, jadi aktifkan setelah obrolan dasar berfungsi dan mulailah dengan tugas hanya-baca. Ini dapat tetap nonaktif untuk pengujian obrolan hanya koneksi. ### Kapan mengaktifkan input gambar Aktifkan hanya untuk model yang secara eksplisit ditandai sebagai menerima gambar. Peralihan klien tidak dapat menambahkan kemampuan penglihatan ke model hanya teks. ### Kapan mengaktifkan mode penalaran Aktifkan ketika katalog atau dokumentasi model secara eksplisit mencantumkan alasan, pemikiran, atau mode serupa. Pertahankan upaya otomatis dan Izinkan penonaktifan alasan. Jangan menambahkan nilai upaya yang tidak didukung, dan jangan menjadikan mode hanya penalaran sebagai default untuk tugas biasa. ## Menambahkan model lain Jangan menimpa entri model yang berfungsi. Buka **Tambahkan model** lagi, pertahankan URL OmniaKey dan kunci API yang sama, ganti hanya ID model yang tepat, dan simpan sebagai model khusus lainnya. Verifikasi satu model sebelum menambahkan model berikutnya. Ketika masalah muncul, ini memperjelas entri tersimpan mana yang menyebabkannya. ## Pemecahan masalah berdasarkan gejala ### Konfigurasi model kustom tidak ada Periksa versi WorkBuddy terlebih dahulu. Perbarui ke `v4.22.15` atau lebih baru, lalu lihat di pemilih model tugas baru atau di **Pengaturan Sistem → Model**. ### HTTP 401, Kunci API tidak sah atau tidak valid Salin lagi kunci OmniaKey. Periksa spasi dan pastikan Anda tidak menempelkan `Bearer` dengannya. Konfirmasikan bahwa kunci telah diaktifkan dan belum kedaluwarsa, serta saldo akun dan batas kunci dapat digunakan. Mengubah ID model tidak memperbaiki `401`; otentikasi gagal sebelum pemilihan model penting. ### HTTP 404 atau titik akhir tidak ditemukan Alamatnya harus persis: ```text https://api.omniakey.com/v1 ``` Jangan gunakan domain kosong, duplikat `/v1`, atau tambahkan `/chat/completions`. Pastikan juga **Protokol khusus** tidak aktif. ### Model tidak ditemukan atau `UNKNOWN_MODEL` Salin lagi ID dari [katalog model langsung](https://omniakey.com/id/models). Nama tampilan, tebakan alias, atau ID yang dihentikan bukan merupakan ID model saat ini yang valid. ### Obrolan berfungsi tetapi alat gagal Koneksi model dasar sudah berfungsi. Periksa sakelar Tool calling WorkBuddy dan kemampuan alat model. Memasukkan kembali kunci atau URL API tidak akan menambah dukungan alat. ### Input gambar gagal Kedua kondisi tersebut harus benar: model mendukung gambar dan kontrol input Gambar WorkBuddy diaktifkan. ### Model hilang setelah Simpan Konfirmasikan bahwa Anda memilih **Simpan**, lalu buka kembali alat pilih model. Mulai ulang WorkBuddy jika perlu. Jika entri konfigurasi itu sendiri tidak tersedia, periksa kembali versi klien. ## Pertanyaan yang sering diajukan ### URL OmniaKey apa yang harus digunakan WorkBuddy? Gunakan hanya `https://api.omniakey.com/v1`. Ini adalah Base URL; WorkBuddy menambahkan jalur operasi. ### Apakah saya memerlukan file `models.json`? Tidak. Panduan ini mengikuti antarmuka **Konfigurasi model kustom** saat ini. Petunjuk file konfigurasi lokal yang lebih lama menjelaskan jalur pengaturan yang berbeda. ### Bisakah saya mengonfigurasi GPT, Claude, Gemini, atau model lainnya? Ya, jika model saat ini terdaftar di OmniaKey dan mendukung rute yang kompatibel dengan OpenAI. Pertahankan URL yang sama dan gunakan ID model katalog yang sama. ### Apakah MCP dikonfigurasi pada formulir ini? Tidak. Formulir ini mengonfigurasi model API. MCP dan konektor adalah pengaturan WorkBuddy yang terpisah. Tetapkan respons model dasar sebelum menambahkan alat tersebut. ## Referensi terverifikasi - [Tencent Cloud: konfigurasikan dan gunakan WorkBuddy](https://cloud.tencent.com/document/product/1823/130064) - [Referensi OmniaKey OpenAI yang kompatibel dengan API](https://docs.omniakey.com/en/api/openai-compatible) - [Katalog model langsung OmniaKey](https://omniakey.com/id/models)