AZZ API

Tutorial Menghubungkan API Relay ke Cursor: Konfigurasi Base URL Kustom

Konfigurasikan API Key kustom dan Base URL di menu Settings → Models pada Cursor untuk menggunakan model Claude / GPT / Gemini dengan kunci dari situs kami.

I. Apa itu Cursor?

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

Setelah terhubung ke relay, Anda dapat menggunakan model Claude / GPT / Gemini dengan sistem pay-as-you-go per token menggunakan kunci sk- dari situs kami tanpa perlu berlangganan Cursor resmi.

II. Persiapan

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

III. Konfigurasi di Cursor

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

  1. Pilih penyedia model yang ingin dihubungkan (OpenAI untuk Open AI, Claude untuk Anthropic, Gemini untuk Google Gemini).
  2. Masukkan API Key: sk-kunci_anda.
  3. Masukkan Override Base URL: Isi sesuai dengan 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 tepat yang ingin digunakan di daftar Models (salin slug dari daftar model, jangan gunakan nama tampilan).
  5. Klik Verify untuk memverifikasi koneksi; lalu kirim teks singkat menggunakan Chat biasa untuk memastikan respons berjalan normal.

IV. Verifikasi dan Pemecahan Masalah

FenomenaSolusi
401 / 403Kunci tidak valid, belum diaktifkan, atau saldo tidak cukup; pastikan sk- sudah benar dan lakukan pengisian saldo.
404 / Model tidak tersediaSlug model tidak sesuai dengan platform atau model belum diaktifkan; periksa kembali ID model.
Verify berhasil tapi Agent gagalPerbedaan protokol /chat/completions; gunakan Chat biasa untuk memastikan konektivitas dasar.
Tab Completion tidak munculFitur khusus seperti Tab Completion tetap menggunakan model internal Cursor. Ini adalah batasan produk dan bukan masalah konfigurasi Base URL.

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