Tutorial Menggunakan API Relay di Cursor: Konfigurasi Base URL Kustom

1. Apa itu Cursor?

Cursor adalah editor kode berbasis AI yang dibangun di atas VS Code, yang mengintegrasikan percakapan AI (Chat), pembuatan kode (Composer/Chat), dan pelengkapan cerdas secara mendalam. Cursor mendukung BYOK (Bring Your Own Key), yang berarti Anda dapat menggunakan API Key Anda sendiri untuk terhubung ke endpoint model pribadi. Ini cocok bagi mereka yang tidak ingin membeli langganan resmi atau ingin beralih ke model tertentu secara terpadu.

Setelah terhubung ke relay, Anda dapat menggunakan model Claude / GPT / Gemini melalui kunci sk- dengan skema penagihan per token, tanpa harus membeli langganan resmi Cursor.

2. Persiapan

1. Masuk ke konsol API, buat kunci sk-xxxxxx eksklusif Anda di menu "API Keys".
2. Konfirmasi slug model yang ingin digunakan di "Model Pricing" (misalnya claude-sonnet-5, gpt-5.5, gemini-3.7-flash).
3. Konfirmasi alamat gateway: https://www.relay-api.com.

3. Konfigurasi di Cursor

Buka Cursor → Settings → Models → API Keys (atau cari Models langsung di pengaturan):

1. Pilih penyedia model yang ingin dihubungkan (OpenAI untuk item Open AI, Claude untuk item Anthropic, Gemini untuk item Google Gemini).
2. Masukkan API Key: sk-kunci_anda.
3. Masukkan Override Base URL: Isi sesuai gateway penyedia yang dipilih.
   • Claude / Anthropic: https://www.relay-api.com
   • GPT / OpenAI: https://www.relay-api.com/v1
   • Gemini: https://www.relay-api.com/v1beta
4. Tambahkan ID model yang ingin digunakan di daftar Models (salin slug dari daftar model, jangan gunakan nama tampilan/display name).
5. Klik Verify untuk memvalidasi koneksi; lalu gunakan Chat biasa untuk mengirim teks singkat guna memastikan respons berjalan normal.

4. Verifikasi dan Pemecahan Masalah

Gejala	Solusi
401 / 403	Kunci tidak valid, belum diaktifkan, atau saldo habis; periksa kembali kunci sk- dan isi ulang saldo.
404 / Model tidak tersedia	Slug model tidak cocok dengan platform, atau model belum diaktifkan; periksa kembali ID model.
Verify berhasil tetapi Agent gagal	Perbedaan protokol /chat/completions, gunakan Chat biasa untuk memeriksa konektivitas dasar terlebih dahulu.
Tab Completion tidak berfungsi	Fungsi khusus seperti Tab Completion tetap menggunakan model bawaan Cursor; ini adalah batasan produk, bukan masalah konfigurasi Base URL.

Saran Keamanan: Jangan kirim kunci API ke repositori publik. Disarankan untuk membuat kunci terpisah untuk setiap proyek dan pantau saldo serta detail penggunaan Anda.

Penjelasan Base URL: Situs ini menerima /v1beta/models/... maupun /v1beta/v1beta/models/... (serta /v1/... dan /v1/v1/...), jadi apakah klien menambahkan /v1 atau /v1beta secara otomatis tidak akan memengaruhi panggilan: Anda bisa mengisi Base URL dengan akar domain saja atau dengan alamat yang menyertakan /v1beta. Silakan salin ID model dari menu "Model ID" di sudut kanan atas halaman "Token" di konsol.