> ## 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.

# APIMart in Cursor verwenden

> Ausführliche Anleitung zur Konfiguration und Nutzung des APIMart-API-Dienstes im KI-Code-Editor Cursor. Diese Anleitung hilft Ihnen, APIMart in Cursor einzurichten, um auf zahlreiche KI-Modelle für die Code-Entwicklung zuzugreifen.

## Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher:

1. **Cursor ist installiert**\
   Laden Sie die für Ihr Betriebssystem passende Version von der [Cursor-Website](https://cursor.sh/) herunter

2. **Sie haben einen APIMart-API-Schlüssel**\
   Melden Sie sich in der [APIMart-Konsole](https://apimart.ai/keys) an, um Ihren API-Schlüssel zu erhalten (beginnt mit `sk-`)

<Note>**Tipp:** Wenn Sie noch kein APIMart-Konto haben, registrieren Sie sich zuerst bei [APIMart](https://apimart.ai) und holen Sie sich einen API-Schlüssel.</Note>

## Schritt 1: Cursor-Einstellungen öffnen

Nach dem Start von Cursor öffnen Sie die Einstellungen:

1. Klicken Sie auf das **⚙️ Settings**-Symbol (Zahnrad) oben rechts
2. Oder verwenden Sie Tastenkürzel:
   * 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>*Cursor-Hauptoberfläche — Einstellungen über das Zahnrad oben rechts öffnen*</caption>

## Schritt 2: Modelleinstellungen konfigurieren

### 2.1 Modelleinstellungen öffnen

In den Einstellungen:

1. Suchen Sie **Models** in der linken Seitenleiste
2. Öffnen Sie die Seite der Modelleinstellungen

<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>*Finden Sie „Models" in der linken Seitenleiste*</caption>

### 2.2 OpenAI-API-Schlüssel verwenden

Auf der Modelleinstellungsseite:

1. Suchen Sie den Abschnitt **OpenAI API Key**
2. Klicken Sie auf **Add new** oder **Override OpenAI Base URL**

<Note>**Wichtig:** Cursor unterstützt OpenAI-kompatible APIs, daher kann APIMart als benutzerdefinierter Anbieter konfiguriert werden.</Note>

### 2.3 APIMart konfigurieren

Geben Sie Folgendes ein:

| Einstellung  | Wert                                          |
| ------------ | --------------------------------------------- |
| **API Key**  | Ihr APIMart-API-Schlüssel (`sk-xxxxxxxxxxxx`) |
| **Base URL** | `https://api.apimart.ai/v1`                   |

<Note>
  **Wichtig:** - Base URL muss das `/v1`-Suffix enthalten: `https://api.apimart.ai/v1` - Der API-Schlüssel muss der `sk-...`-Schlüssel aus der APIMart-Konsole sein - Nach dem Speichern verwendet Cursor APIMart-Modelle für Vervollständigung und 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>*API-Schlüssel und Base URL eingeben*</caption>

## Schritt 3: Modelle auswählen

### 3.1 Modellauswahl

<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>

In den Modelleinstellungen können Sie wählen, welche Modelle verwendet werden sollen.

**Verfügbare Familien:**

* **GPT-4/5** — stark bei komplexer Codegenerierung und Q\&A
  * `gpt-5` — neuestes GPT-5
  * `gpt-4o` — GPT-4o
  * `gpt-4o-mini` — schneller, kostengünstiger

* **Claude** — stark beim Verstehen und Refactoring
  * `claude-sonnet-4-5-20250929` — Claude Sonnet 4.5
  * `claude-haiku-4-5-20251001` — Claude Haiku 4.5

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

<Tip>
  **Empfehlungen:** - 💰 **Vervollständigung (kosteneffizient):** `gpt-4o-mini` - 🚀 **Anspruchsvolle Aufgaben (Leistung):** `gpt-5`, `gpt-4o`, `claude-sonnet-4-5-20250929` - ⚡ **Niedrige Latenz:** `gpt-4o-mini`, `gemini-2.0-flash-exp`
</Tip>

### 3.2 Modelle pro Funktion

Sie können verschiedene Modelle pro Funktion wählen:

* **Chat** — Konversationen mit der KI
* **Autocomplete** — Inline-Vorschläge
* **Cmd+K** — schnelle Bearbeitung / Generierung

Wählen Sie das passendste Modell für jeden Workflow.

## Schritt 4: Loslegen

Nach der Konfiguration können Sie die KI-Funktionen von Cursor nutzen.

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

1. Drücken Sie `Cmd+L` (macOS) oder `Ctrl+L` (Windows/Linux)
2. Stellen Sie eine Frage oder geben Sie eine Aufgabe, z. B.:
   * „Wie implementiere ich Quicksort?"
   * „Hilf mir, die Leistung dieses Codes zu optimieren"
   * „Erkläre, wie diese Funktion arbeitet"

<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 mit dem Assistenten*</caption>

### 4.2 Code-Vervollständigung

1. Tippen Sie wie gewohnt im Editor
2. Cursor schlägt Vervollständigungen vor
3. Drücken Sie `Tab`, um anzunehmen

<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>*Beispiel für Inline-Vervollständigung*</caption>

### 4.3 Schnellbearbeitung (`Cmd+K` / `Ctrl+K`)

1. Code auswählen
2. `Cmd+K` (macOS) oder `Ctrl+K` (Windows/Linux) drücken
3. Bearbeitung beschreiben, z. B.:
   * „Fehlerbehandlung hinzufügen"
   * „Diese Funktion refactoren"
   * „Typannotationen hinzufügen"

<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="Quick edit" width="1920" height="1031" data-path="images/integrations/cursor/quick-edit.png" />
</Frame>

<caption>*Schnellbearbeitung mit Cmd+K*</caption>

### 4.4 Code erklären

1. Code auswählen
2. Rechtsklick → **Explain with AI** (oder Tastenkürzel)
3. Die KI erklärt Verhalten und Logik

## FAQ

### Q1: APIMart nicht erreichbar?

**Versuchen Sie:**

1. **Base URL** — muss exakt `https://api.apimart.ai/v1` sein
2. **API-Schlüssel** — gültiger `sk-...`-Schlüssel aus der [Konsole](https://apimart.ai/keys)
3. **Netzwerk** — stellen Sie sicher, dass `https://api.apimart.ai` erreichbar ist; in einigen Regionen kann ein Proxy erforderlich sein

### Q2: Langsame Antworten?

**Versuchen Sie:**

1. Verwenden Sie ein leichteres Modell (`gpt-4o-mini` statt `gpt-4o` oder `gemini-2.0-flash-exp`)
2. Kontext kürzen — weniger Code senden, präzisere Fragen stellen
3. Latenz / Proxy bei Bedarf prüfen

### Q3: API-Fehler?

| Meldung                     | Wahrscheinliche Ursache                | Was tun                                             |
| --------------------------- | -------------------------------------- | --------------------------------------------------- |
| `401 Unauthorized`          | Ungültiger oder abgelaufener Schlüssel | Schlüssel neu erstellen und in Cursor aktualisieren |
| `429 Too Many Requests`     | Rate-Limit                             | Warten und erneut versuchen                         |
| `500 Internal Server Error` | Vorübergehendes Serverproblem          | Später erneut versuchen                             |
| `insufficient_quota`        | Geringes Guthaben                      | In der Konsole aufladen                             |

### Q4: Nutzung und Abrechnung?

Öffnen Sie die [APIMart-Konsole](https://apimart.ai/overview):

* 📊 Aufrufstatistiken
* 💰 Kostenaufschlüsselung
* 📈 Nutzungstrends
* 🔍 Anfrageprotokolle

## Tipps

### 1. Kontext nutzen

* Verwandte Dateien öffnen
* Dateien mit `@filename` referenzieren
* Ordner mit `@folder` referenzieren

### 2. Klare Prompts

**❌ Schwach:**

```
optimize this
```

**✅ Stark:**

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

### 3. Iterieren

Klein anfangen → verfeinern → testen → Prompts anpassen.

### 4. Projektregeln

Definieren Sie Stil, Benennung, Architektur und Tests in `.cursorrules`.

## Funktionen

Mit Cursor + APIMart:

* 💬 Chat zu Code-Fragen
* ⚡ Intelligente Vervollständigung
* ✏️ Bearbeitung in natürlicher Sprache
* 🔍 Tieferes Codeverständnis
* 🐛 Hilfe beim Debuggen
* 📝 Dokumentation und Kommentare
* 🔄 Refactoring
* 🧪 Test-Gerüste

## Support

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

***

<Card title="Mit APIMart loslegen" icon="rocket" href="https://apimart.ai">
  Registrieren, API-Schlüssel holen und mit Cursor schneller liefern!
</Card>