Tutorial Menghubungkan Windsurf ke Relay: Konfigurasi Endpoint Kustom Agen Cascade
Tutorial menghubungkan Codeium Windsurf AI IDE: Konfigurasi endpoint model kustom dan API Key di pengaturan untuk memanggil berbagai model Claude / GPT / Gemini.
I. Apa itu Windsurf
Windsurf adalah IDE berbasis AI yang dilengkapi dengan agen Cascade, serta mendukung penambahan endpoint model khusus. Anda cukup mengarahkannya ke gateway situs ini untuk memanggil Claude / GPT / Gemini menggunakan kunci API yang terpadu.
II. Persiapan
- Masuk ke konsol API, buat API Key
sk-xxxxxx(hanya akan ditampilkan sekali, harap simpan). - Pastikan slug model yang ingin digunakan (contoh:
claude-sonnet-5,gpt-5.5,gemini-3.7-flash). - Pastikan alamat gateway:
https://www.relay-api.com.
III. Konfigurasi di Windsurf
Buka Settings → Models / API Providers → Add Provider, pilih jenis penyedia, lalu isi:
Base URL : https://www.relay-api.com # Claude / Anthropic
API Key : sk-kunci_anda
Model : claude-sonnet-5
(Untuk model GPT, ubah Base URL ke https://www.relay-api.com/v1)
(Untuk model Gemini, ubah Base URL ke https://www.relay-api.com/v1beta)Setelah disimpan, pilih model tersebut di Cascade, lalu gunakan Ctrl+L (macOS Cmd+L) untuk memulai percakapan.
IV. Perbandingan Alamat Antarmuka
| Grup Model | Entri Situs (Base URL) | Protokol |
|---|---|---|
| Claude / Anthropic | https://www.relay-api.com | Anthropic Messages |
| GPT / OpenAI | https://www.relay-api.com/v1 | OpenAI Chat Completions |
| Gemini | https://www.relay-api.com/v1beta | Google generateContent |
Gunakan entri pada tabel di atas untuk Base URL.
V. Pemecahan Masalah
| Gejala | Penanganan |
|---|---|
| 401 / 403 | Kunci tidak valid, belum diaktifkan, atau saldo tidak cukup; pastikan sk- sudah benar dan lakukan isi ulang. |
| 404 / Model tidak tersedia | Nama model tidak sesuai dengan slug platform, atau model tersebut belum diaktifkan; periksa kembali ID model. |
Saran Keamanan: Jangan tuliskan kunci API di repositori publik; buat kunci terpisah untuk tujuan berbeda agar mudah dipantau dan dibatasi.
Catatan Base URL: Situs ini menerima /v1beta/models/... maupun /v1beta/v1beta/models/... (serta /v1/... dan /v1/v1/...), jadi apakah klien Anda menambahkan /v1 atau /v1beta secara otomatis tidak akan memengaruhi pemanggilan: Base URL dapat diisi dengan root domain atau alamat yang disertai /v1beta. Silakan salin ID model melalui menu "Model ID" di sudut kanan atas halaman "Token" pada konsol.