Trae + JoinGonka Gateway — model jaringan Gonka di AI-IDE

Build dan versi. Trae punya dua cabang: internasional (dokumentasi di docs.trae.ai) dan Tiongkok (docs.trae.cn). Formulir Custom Model ada di keduanya dan cara kerjanya sama; yang berbeda adalah model bawaan dan rangkaian preset di pengaturan tambahan. Alamat permintaan kustom untuk model sendiri didukung sejak versi 3.5.51 tanggal 14 April 2026 — jika build Anda lebih lama, perbarui dulu. Build internasional tidak tersedia di semua negara: sebelum memasang, cek daftar negara dan wilayah yang didukung.

Sistem. macOS 12 dan lebih baru, Windows 10 atau 11 (x64), Linux dalam paket .deb dan .rpm. Saat pertama kali dijalankan, Trae akan menawarkan untuk memilih tema dan bahasa, mengimpor pengaturan dari VS Code atau Cursor, dan masuk ke akun.

Kunci JoinGonka. Daftar di gateway, buka bagian « API Key » di dasbor, lalu klik « Buat kunci ». Kunci diawali dengan jg- dan hanya ditampilkan sekali — segera simpan. Sebaiknya buat kunci terpisah untuk Trae: di bagian « Penggunaan », konsumsinya akan terlihat di baris tersendiri.

Paket Trae. Model sendiri harus dipilih secara manual di daftar model, sedangkan di tabel paket Trae, baris pemilihan model pada paket gratis hanya mencantumkan mode Auto — di mode itu model sendiri tidak dipakai. Apakah batasan ini berlaku juga untuk model yang ditambahkan dengan kunci sendiri, dokumentasinya tidak menyatakannya secara gamblang. Aturan praktisnya sederhana: jika di paket Anda Auto Mode bisa dimatikan di daftar model, semuanya siap; jika tidak, Anda perlu paket berbayar.

1. Buka Settings → Models — panel pengaturan model.
2. Klik Add Model. Di jendela yang muncul, pilih opsi Custom Model, bukan penyedia dari daftar siap pakai.
3. Isi kolom-kolom dengan nilai dari tabel. Ada dua kolom — untuk masing-masing format API; pilih salah satu.
4. Klik Add Model. Trae akan melakukan panggilan API uji coba dan memeriksa kunci: jika berhasil, model akan muncul di daftar; jika gagal, jendela akan menampilkan pesan kesalahan dan log respons penyedia.

Kolom lainnya tidak bergantung pada format:

Format mana yang harus dipilih. Mulailah dengan OpenAI Chat Completions: ini jalur utama gateway, dan sebagian besar alat bekerja dengannya. Anthropic Messages berguna jika Anda sudah terbiasa dengan format ini di alat lain atau ingin membandingkan perilaku agen pada dua protokol — kunci dan saldonya sama.

Cara kerja Full URL. Tombol ini menentukan siapa yang menambahkan jalur. Nonaktif — Anda memberikan alamat dasar, dan Trae menambahkan jalur sesuai format yang dipilih: /chat/completions ke alamat dengan /v1 untuk OpenAI dan /v1/messages ke root untuk Anthropic. Aktif — alamat digunakan apa adanya, dan jalur harus ditulis lengkap di dalamnya. Kesalahan paling umum adalah mencampur mode: menuliskan jalur lengkap saat tombol nonaktif atau alamat dasar saat tombol aktif.

Satu entri — satu model. Ulangi langkah-langkah untuk model lain di jaringan agar Anda bisa beralih di antara mereka tanpa kembali ke pengaturan: deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7 dan zai-org/GLM-5.3-Flash. Daftar terkini disediakan oleh GET https://gate.joingonka.ai/v1/models. Model yang sudah ditambahkan nantinya bisa diedit, dinonaktifkan (tetap ada di panel, tetapi hilang dari daftar di chat) atau dihapus.

Di bawah kolom utama terdapat daftar yang bisa diciutkan, Advanced Settings. Anda tidak perlu mengubahnya — Trae akan mengisi nilai default — namun ada dua pengaturan yang patut ditentukan secara sadar: seri model dan jendela konteks.

Harga untuk model jaringan sama, jadi pilihan bergantung pada perilaku. Semua model dari tabel mendukung tool calling asli, yang menjadi dasar kerja agen Trae.

Bagaimana anggaran penalaran diatur dan mengapa batas output model penalaran tidak boleh terlalu rendah telah dibahas dalam tinjauan GLM-5.3 Flash; perbandingan model untuk tugas pengembangan terdapat dalam artikel tentang model terbaik untuk kode.

Model Anda tersimpan dalam daftar umum: klik nama model saat ini di sudut kanan bawah kolom input chat dan pilih model yang telah ditambahkan. Sakelar Auto Mode juga ada di sana — pastikan untuk mematikannya: dalam mode Auto, Trae akan memilih sendiri model dari model bawaan dan tidak menggunakan model yang Anda tambahkan.

Berikan tugas kepada agen yang memerlukan alat, misalnya: «Baca package.json dan sebutkan skrip build-nya». Agen harus membuka file dan menjawab dengan tepat — ini berarti siklus «permintaan — panggilan alat — jawaban» melalui gateway sudah terhubung dengan benar. Setelah itu, buka dasbor gateway, bagian «Penggunaan»: di blok «Berdasarkan kunci», permintaan dan waktu akses terakhir akan muncul untuk kunci Trae, dan di blok «Berdasarkan model», model yang dipilih akan muncul.

Jika ada masalah, periksa teks error-nya. Trae tidak menyembunyikan respons model Anda sendiri: error dari penyedia akan ditampilkan apa adanya dengan kode 4028 miliknya sendiri.

Agen di IDE menghabiskan token lebih cepat daripada chat: setiap permintaan menyertakan instruksi sistem, deskripsi alat, file yang dibuka, dan riwayat langkah. Oleh karena itu, harga per token menentukan apakah Anda bisa menjalankan agen untuk setiap hal kecil atau harus berhemat.

Melalui JoinGonka Gateway, token berharga $0.0069 per juta di input dan $0.021 per juta di output — harga sama untuk semua model jaringan dan diperbarui di halaman ini dari sumber langsung. Kisaran harga pada September 2026:

Perbandingan dengan Trae sendiri cukup jelas, karena ada model terbuka di antara model bawaan, dan Trae memublikasikan daftar harga mereka per juta token. DeepSeek-V4-Flash dan MiniMax-M2.7 di sana berharga $0.30 di input dan $1.20 di output, sedangkan GLM-5.3 Flash tidak ada sama sekali dalam daftar bawaan versi internasional. Melalui gateway, selisih untuk model yang sama adalah sekitar ×43 pada input dan ×58 pada output.

Model Anda sendiri bekerja di mana ada daftar model. Ini adalah chat dan agen — baik dalam mode IDE maupun di SOLO (model sendiri didukung di dalamnya sejak versi 3.3.0). Pelengkap otomatis dan prediksi pengeditan adalah mekanisme terpisah CUE dengan panel pengaturannya sendiri: tidak ada pilihan model di dalamnya, dan batasannya ditentukan oleh paket tarif Trae.

Alat dan MCP. Agen Trae bertindak sebagai klien MCP, dan server yang Anda hubungkan tetap tersedia bagi agen pada modelnya sendiri: semua model jaringan mendukung pemanggilan alat secara native. Jika Trae melaporkan bahwa skema argumen alat tidak kompatibel dengan model (kode 4027), coba model jaringan tetangga atau server MCP lainnya.

TraeWork. Di aplikasi terpisah TraeWork, formulir penambahan model sendiri sama, tetapi menurut dokumentasi, ini hanya berfungsi di TraeWork Desktop dan hanya untuk tugas di lingkungan lokal.

Plugin untuk editor lain. Dalam dokumentasi plugin TraeCode untuk VS Code dan JetBrains, tidak ada bagian tentang model sendiri — panduan ini berlaku untuk IDE desktop. Jika Anda tetap di VS Code, gateway yang sama dihubungkan melalui ekstensi agen, misalnya Cline.

Privasi. Pengaturan Privacy Mode (Settings → Account) mengontrol apa yang dilakukan Trae dengan dialog dan fragmen kode Anda: dengan fitur ini, mereka tidak akan masuk ke analitik dan pelatihan. Dari sisi gateway, dialog tidak disimpan: prompt dan respons tidak tersisa di sana setelah jawaban, di akun hanya terlihat penghitung permintaan dan token.

Jika Anda perlu bekerja dengan gambar — maket, tangkapan layar kesalahan — serahkan tugas tersebut kepada model bawaan dengan visi, dan biarkan kode, perintah, dan file pada model jaringan: perpindahan hanya butuh satu klik di daftar model.