Pengaturan Kunci API TRAE — Panduan Konfigurasi Kunci Pihak Ketiga Agen
Konfigurasikan APIMaster.ai sebagai API pihak ketiga di Agen TRAE IDE. Gunakan pengaturan OpenAI Chat Completions kustom dengan URL dasar dan ID model untuk GPT, Claude, DeepSeek, dan lainnya.
TRAE IDE (IDE pengkodean asli AI milik ByteDance) menyertakan mode Agen yang memahami tugas, merencanakan pekerjaan, dan mengedit kode secara otonom. TRAE mendukung model kustom melalui kunci API pihak ketiga. APIMaster.ai menyediakan titik akhir yang kompatibel dengan OpenAI Chat Completions—tambahkan model kustom di TRAE untuk terhubung.
Dapatkan Kunci API terlebih dahulu. Kunci hanya tersimpan di mesin Anda. Gunakan tes konektivitas jika permintaan gagal.
Prasyarat
- TRAE IDE terpasang (trae.ai atau trae.cn).
- Kunci API APIMaster dari konsol.
- ID model target dari marketplace (mis.
gpt-5.5,claude-sonnet-4-6,deepseek-v4-pro).
Langkah 1 — Buka Agen dan tambahkan model
- Buka TRAE IDE dan buka obrolan Agen (
@Agentdi bilah input). - Klik pemilih model di kanan bawah (dropdown di samping nama model saat ini).
- Di bagian bawah menu, klik Tambah Model (添加模型).

Langkah 2 — Konfigurasi kustom
Di dialog Edit Model, buka tab Konfigurasi Kustom (自定义配置) dan isi:
| Bidang | Nilai |
|---|---|
| Format API | OpenAI Chat Completions |
| URL permintaan kustom | https://apimaster.ai/v1 (tanpa garis miring di akhir) |
| URL Lengkap | Mati (TRAE menambahkan /chat/completions secara otomatis) |
| ID Model | ID model dari Marketplace, mis. gpt-5.5, claude-sonnet-4-6 |
| Multimodal | Aktif jika model mendukung gambar; mati untuk teks saja |
| Kunci API | Kunci APIMaster Anda |

Catatan:
- Gunakan titik akhir yang kompatibel dengan OpenAI:
https://apimaster.ai/v1. TRAE menambahkan/chat/completionske jalur. - ID Model harus cocok persis dengan id marketplace.
- Klik Konfirmasi (确认) untuk menyimpan.
Langkah 3 — Pilih model kustom Anda
- Buka pemilih model lagi.
- Di bawah Model Kustom (自定义模型), pilih model yang Anda tambahkan (mis.
gpt-5.5). - Bilah bawah akan menampilkan ID model Anda.

Langkah 4 — Uji obrolan Agen
- Kirim pesan uji di Agen (mis.
hiatau tugas pengkodean kecil). - Balasan normal berarti pengaturan berhasil.
- Jika TRAE menampilkan penyedia
custom_openai_compatible, permintaan dikirim melalui APIMaster melalui protokol yang kompatibel dengan OpenAI.

Contoh ID model
| ID model | Catatan |
|---|---|
gpt-5.4 / gpt-5.5 |
GPT |
claude-haiku-4-5 |
Claude Haiku |
claude-sonnet-4-6 |
Claude Sonnet |
claude-opus-4-7 / claude-opus-4-8 |
Claude Opus |
deepseek-v4-pro / deepseek-v4-flash |
DeepSeek |
gemini-2.5-pro / gemini-2.5-flash |
Gemini |
Salin ID dari marketplace—jangan menebak alias.
Pemecahan Masalah
| Masalah | Perbaikan |
|---|---|
| 401 / Kunci API Tidak Valid | Tempel ulang kunci; periksa apakah aktif di konsol |
| 404 / model tidak ditemukan | Salin ulang ID Model dari marketplace |
| Timeout | URL harus https://apimaster.ai/v1 (tanpa garis miring di akhir); periksa jaringan/proxy |
| Tidak ada tombol Tambah Model | Gunakan pemilih model obrolan Agen (kanan bawah), bukan sidebar Builder |
| Masih menggunakan model bawaan | Pilih entri Anda di bawah Model Kustom |
| Kesalahan multimodal | Matikan Multimodal jika model hanya teks |
Daftar Periksa
- Membuka pemilih model Agen → Tambah Model
- Format API = OpenAI Chat Completions
- URL permintaan kustom =
https://apimaster.ai/v1(URL Lengkap mati) - ID Model dari marketplace
- Kunci API = kunci APIMaster
- Model kustom dipilih; Agen merespons dengan sukses