> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Menggunakan APIMart di Cursor

> Panduan terperinci untuk mengonfigurasi dan menggunakan layanan API APIMart di editor kode AI Cursor. Panduan ini membantu Anda mengatur API APIMart di Cursor untuk mengakses beragam sumber daya model AI dalam pengembangan kode.

## Prasyarat

Sebelum memulai, pastikan:

1. **Cursor sudah terinstal**\
   Unduh dan instal versi yang sesuai untuk OS Anda dari [situs Cursor](https://cursor.sh/)

2. **Anda memiliki API key APIMart**\
   Masuk ke [Konsol APIMart](https://apimart.ai/keys) untuk mendapatkan API key Anda (diawali dengan `sk-`)

<Note>**Tips:** Jika Anda belum memiliki akun APIMart, daftar di [APIMart](https://apimart.ai) dan dapatkan API key terlebih dahulu.</Note>

## Langkah 1: Buka Pengaturan Cursor

Setelah menjalankan Cursor, buka Settings:

1. Klik ikon **⚙️ Settings** (roda gigi) di sudut kanan atas
2. Atau gunakan pintasan:
   * Windows/Linux: `Ctrl+Shift+J`
   * macOS: `Cmd+Shift+J`

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/main-interface.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=0cdb42d41c54585a4fdb57605722a617" alt="Cursor main interface" width="1200" height="800" data-path="images/integrations/cursor/main-interface.png" />
</Frame>

<caption>*Antarmuka utama Cursor — buka Settings dari roda gigi kanan atas*</caption>

## Langkah 2: Konfigurasikan pengaturan model

### 2.1 Buka pengaturan model

Di Pengaturan:

1. Temukan **Models** di sidebar kiri
2. Buka halaman pengaturan model

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/settings-models.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=58aa677bafc3c5baf2f1cecbadc2f6c7" alt="Cursor Settings - Models" width="1200" height="800" data-path="images/integrations/cursor/settings-models.png" />
</Frame>

<caption>*Temukan "Models" di sidebar kiri*</caption>

### 2.2 Gunakan OpenAI API Key

Di halaman pengaturan model:

1. Temukan bagian **OpenAI API Key**
2. Klik **Add new** atau **Override OpenAI Base URL**

<Note>**Penting:** Cursor mendukung API yang kompatibel dengan OpenAI, sehingga APIMart dapat dikonfigurasi sebagai provider kustom.</Note>

### 2.3 Konfigurasikan APIMart

Masukkan informasi berikut:

| Pengaturan   | Nilai                                    |
| ------------ | ---------------------------------------- |
| **API Key**  | API key APIMart Anda (`sk-xxxxxxxxxxxx`) |
| **Base URL** | `https://api.apimart.ai/v1`              |

<Note>
  **Penting:** - Base URL harus menyertakan sufiks `/v1`: `https://api.apimart.ai/v1` - API key harus berupa key `sk-...` dari konsol APIMart - Setelah disimpan, Cursor menggunakan model APIMart untuk completion dan chat
</Note>

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/api-config.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=96fdcd9f4cb5894281096afacc3e8157" alt="APIMart API configuration" width="1200" height="800" data-path="images/integrations/cursor/api-config.png" />
</Frame>

<caption>*Masukkan API Key dan Base URL*</caption>

## Langkah 3: Pilih model

### 3.1 Pemilihan model

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/api-model.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=162421d76a09a5831298a9cc6194fed4" alt="Model selection" width="1200" height="800" data-path="images/integrations/cursor/api-model.png" />
</Frame>

Di pengaturan model, Anda dapat memilih model yang akan digunakan.

**Keluarga model yang tersedia:**

* **GPT-4/5** — kuat untuk pembuatan kode kompleks dan tanya jawab
  * `gpt-5` — GPT-5 terbaru
  * `gpt-4o` — GPT-4o
  * `gpt-4o-mini` — lebih cepat, biaya lebih rendah

* **Claude** — kuat untuk pemahaman dan refactoring
  * `claude-sonnet-4-5-20250929` — Claude Sonnet 4.5
  * `claude-haiku-4-5-20251001` — Claude Haiku 4.5

* **Lainnya**
  * `gemini-2.0-flash-exp` — Google Gemini 2.0 Flash

<Tip>
  **Saran:** - 💰 **Penyelesaian (hemat biaya):** `gpt-4o-mini` - 🚀 **Tugas berat (performa):** `gpt-5`, `gpt-4o`, `claude-sonnet-4-5-20250929` - ⚡ **Latensi rendah:** `gpt-4o-mini`, `gemini-2.0-flash-exp`
</Tip>

### 3.2 Model per fitur

Anda dapat memilih model berbeda untuk setiap fitur:

* **Chat** — percakapan dengan AI
* **Autocomplete** — saran inline
* **Cmd+K** — edit / generate cepat

Pilih yang paling sesuai untuk setiap alur kerja.

## Langkah 4: Mulai menggunakan

Setelah dikonfigurasi, Anda dapat menggunakan fitur AI Cursor.

### 4.1 AI Chat (`Cmd+L` / `Ctrl+L`)

1. Tekan `Cmd+L` (macOS) atau `Ctrl+L` (Windows/Linux)
2. Ajukan pertanyaan atau berikan tugas, misalnya:
   * "How do I implement quicksort?"
   * "Help me optimize this code's performance"
   * "Explain how this function works"

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/ai-chat.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=916680a9a52cc82daa87ba904e64944b" alt="AI Chat panel" width="1200" height="800" data-path="images/integrations/cursor/ai-chat.png" />
</Frame>

<caption>*Chat dengan asisten*</caption>

### 4.2 Penyelesaian kode

1. Ketik seperti biasa di editor
2. Cursor menyarankan penyelesaian
3. Tekan `Tab` untuk menerima

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/autocomplete.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=34992c1174e6019df9d21ea5b71bf1b6" alt="Autocomplete" width="1925" height="1025" data-path="images/integrations/cursor/autocomplete.png" />
</Frame>

<caption>*Contoh penyelesaian inline*</caption>

### 4.3 Edit cepat (`Cmd+K` / `Ctrl+K`)

1. Pilih kode
2. Tekan `Cmd+K` (macOS) atau `Ctrl+K` (Windows/Linux)
3. Jelaskan editan, misalnya:
   * "Tambahkan penanganan error"
   * "Refactor fungsi ini"
   * "Tambahkan anotasi tipe"

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/quick-edit.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=eab6aa4afabc8f28ff3cd246bb2ebea7" alt="Edit cepat" width="1920" height="1031" data-path="images/integrations/cursor/quick-edit.png" />
</Frame>

<caption>*Edit cepat dengan Cmd+K*</caption>

### 4.4 Jelaskan kode

1. Pilih kode
2. Klik kanan **Explain with AI** (atau gunakan shortcut)
3. AI akan menjelaskan perilaku dan logikanya

## FAQ

### Q1: Tidak dapat terhubung ke APIMart?

**Coba:**

1. **Base URL** — harus persis `https://api.apimart.ai/v1`
2. **API key** — key `sk-...` yang valid dari [konsol](https://apimart.ai/keys)
3. **Jaringan** — pastikan `https://api.apimart.ai` dapat dijangkau; proxy mungkin diperlukan di beberapa wilayah

### Q2: Respons lambat?

**Coba:**

1. Gunakan model yang lebih ringan (`gpt-4o-mini` alih-alih `gpt-4o`, atau `gemini-2.0-flash-exp`)
2. Persingkat konteks — kirim lebih sedikit kode, ajukan pertanyaan yang lebih tepat
3. Periksa latensi / proxy bila perlu

### Q3: Error API?

| Pesan                       | Kemungkinan penyebab       | Tindakan                           |
| --------------------------- | -------------------------- | ---------------------------------- |
| `401 Unauthorized`          | Key salah atau kedaluwarsa | Buat ulang key dan perbarui Cursor |
| `429 Too Many Requests`     | Terkena batas laju         | Tunggu lalu coba lagi              |
| `500 Internal Server Error` | Masalah server sementara   | Coba lagi nanti                    |
| `insufficient_quota`        | Saldo rendah               | Isi ulang di konsol                |

### Q4: Penggunaan dan penagihan?

Buka [Konsol APIMart](https://apimart.ai/overview):

* 📊 Statistik panggilan
* 💰 Rincian biaya
* 📈 Tren penggunaan
* 🔍 Log permintaan

## Tips

### 1. Gunakan konteks

* Buka file terkait
* Rujuk file dengan `@filename`
* Rujuk folder dengan `@folder`

### 2. Prompt yang jelas

**❌ Lemah:**

```
optimize this
```

**✅ Kuat:**

```
Optimize this function for performance:
1. Reduce nested loops
2. Prefer more efficient data structures
3. Add caching where helpful
```

### 3. Iterasi

Mulai kecil → perbaiki → uji → sesuaikan prompt.

### 4. Aturan proyek

Tentukan gaya, penamaan, arsitektur, dan tes di `.cursorrules`.

## Fitur

Dengan Cursor + APIMart:

* 💬 Chat untuk pertanyaan coding
* ⚡ Penyelesaian cerdas
* ✏️ Editan dalam bahasa alami
* 🔍 Pemahaman kode yang lebih dalam
* 🐛 Bantuan debugging
* 📝 Dokumentasi dan komentar
* 🔄 Refactoring
* 🧪 Scaffolding test

## Dukungan

* 📚 [Dokumentasi APIMart](https://docs.apimart.ai)
* 💬 [Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Mulai dengan APIMart" icon="rocket" href="https://apimart.ai">
  Daftar, dapatkan API key Anda, dan kirim kode lebih cepat dengan Cursor!
</Card>