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

# Utiliser APIMart dans Cursor

> Guide détaillé sur la façon de configurer et d'utiliser le service API APIMart dans l'éditeur de code IA Cursor. Ce guide vous aidera à configurer l'API APIMart dans Cursor pour accéder à de riches ressources de modèles d'IA pour le développement de code.

## Prérequis

Avant de commencer, assurez-vous que :

1. **Cursor est installé**\
   Téléchargez et installez la version adaptée à votre OS depuis le [site de Cursor](https://cursor.sh/)

2. **Vous avez une clé API APIMart**\
   Connectez-vous à la [console APIMart](https://apimart.ai/keys) pour obtenir votre clé API (commence par `sk-`)

<Note>**Astuce :** si vous n'avez pas encore de compte APIMart, inscrivez-vous sur [APIMart](https://apimart.ai) et obtenez d'abord une clé API.</Note>

## Étape 1 : Ouvrir les paramètres de Cursor

Après avoir lancé Cursor, ouvrez les paramètres :

1. Cliquez sur l'icône **⚙️ Settings** (engrenage) en haut à droite
2. Ou utilisez les raccourcis :
   * 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>*Interface principale de Cursor — ouvrez les paramètres depuis l'engrenage en haut à droite*</caption>

## Étape 2 : Configurer les paramètres du modèle

### 2.1 Ouvrir les paramètres du modèle

Dans les paramètres :

1. Trouvez **Models** dans la barre latérale gauche
2. Ouvrez la page des paramètres du modèle

<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>*Trouvez « Models » dans la barre latérale gauche*</caption>

### 2.2 Utiliser la clé OpenAI API

Sur la page des paramètres du modèle :

1. Trouvez la section **OpenAI API Key**
2. Cliquez sur **Add new** ou **Override OpenAI Base URL**

<Note>**Important :** Cursor prend en charge les API compatibles OpenAI, donc APIMart peut être configuré comme fournisseur personnalisé.</Note>

### 2.3 Configurer APIMart

Saisissez ce qui suit :

| Paramètre    | Valeur                                    |
| ------------ | ----------------------------------------- |
| **API Key**  | Votre clé API APIMart (`sk-xxxxxxxxxxxx`) |
| **Base URL** | `https://api.apimart.ai/v1`               |

<Note>
  **Important :** - La Base URL doit inclure le suffixe `/v1` : `https://api.apimart.ai/v1` - La clé API doit être la clé `sk-...` de la console APIMart - Après la sauvegarde, Cursor utilise les modèles APIMart pour la complétion et le 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>*Saisissez la clé API et la Base URL*</caption>

## Étape 3 : Choisir les modèles

### 3.1 Sélection de modèle

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

Dans les paramètres du modèle, vous pouvez choisir les modèles à utiliser.

**Familles disponibles :**

* **GPT-4/5** — forts pour la génération de code complexe et les Q\&R
  * `gpt-5` — dernier GPT-5
  * `gpt-4o` — GPT-4o
  * `gpt-4o-mini` — plus rapide, moins coûteux

* **Claude** — forts pour la compréhension et le refactoring
  * `claude-sonnet-4-5-20250929` — Claude Sonnet 4.5
  * `claude-haiku-4-5-20251001` — Claude Haiku 4.5

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

<Tip>
  **Suggestions :** - 💰 **Complétion (économique) :** `gpt-4o-mini` - 🚀 **Tâches difficiles (performance) :** `gpt-5`, `gpt-4o`, `claude-sonnet-4-5-20250929` - ⚡ **Faible latence :** `gpt-4o-mini`, `gemini-2.0-flash-exp`
</Tip>

### 3.2 Modèles par fonction

Vous pouvez choisir différents modèles par fonction :

* **Chat** — conversations avec l'IA
* **Autocomplete** — suggestions inline
* **Cmd+K** — édition / génération rapide

Choisissez le meilleur pour chaque workflow.

## Étape 4 : Commencer à utiliser

Une fois configuré, vous pouvez utiliser les fonctionnalités IA de Cursor.

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

1. Appuyez sur `Cmd+L` (macOS) ou `Ctrl+L` (Windows/Linux)
2. Posez une question ou donnez une tâche, par exemple :
   * « Comment implémenter un quicksort ? »
   * « Aide-moi à optimiser la performance de ce code »
   * « Explique comment cette fonction fonctionne »

<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>*Discuter avec l'assistant*</caption>

### 4.2 Complétion de code

1. Tapez comme d'habitude dans l'éditeur
2. Cursor suggère des complétions
3. Appuyez sur `Tab` pour accepter

<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>*Exemple de complétion inline*</caption>

### 4.3 Édition rapide (`Cmd+K` / `Ctrl+K`)

1. Sélectionnez du code
2. Appuyez sur `Cmd+K` (macOS) ou `Ctrl+K` (Windows/Linux)
3. Décrivez l'édition, par ex. :
   * « Ajoute la gestion d'erreurs »
   * « Refactore cette fonction »
   * « Ajoute les annotations de type »

<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>*Édition rapide avec Cmd+K*</caption>

### 4.4 Expliquer le code

1. Sélectionnez le code
2. Clic droit → **Explain with AI** (ou raccourci)
3. L'IA explique le comportement et la logique

## FAQ

### Q1 : Impossible d'atteindre APIMart ?

**Essayez :**

1. **Base URL** — doit être exactement `https://api.apimart.ai/v1`
2. **Clé API** — clé `sk-...` valide depuis la [console](https://apimart.ai/keys)
3. **Réseau** — assurez-vous que `https://api.apimart.ai` est accessible ; un proxy peut être requis dans certaines régions

### Q2 : Réponses lentes ?

**Essayez :**

1. Utilisez un modèle plus léger (`gpt-4o-mini` au lieu de `gpt-4o`, ou `gemini-2.0-flash-exp`)
2. Raccourcissez le contexte — envoyez moins de code, posez des questions plus précises
3. Vérifiez la latence / le proxy si nécessaire

### Q3 : Erreurs API ?

| Message                     | Cause probable                 | Que faire                                   |
| --------------------------- | ------------------------------ | ------------------------------------------- |
| `401 Unauthorized`          | Mauvaise clé ou clé expirée    | Recréez la clé et mettez à jour dans Cursor |
| `429 Too Many Requests`     | Limite de débit                | Attendez et réessayez                       |
| `500 Internal Server Error` | Problème temporaire du serveur | Réessayez plus tard                         |
| `insufficient_quota`        | Solde faible                   | Rechargez dans la console                   |

### Q4 : Utilisation et facturation ?

Ouvrez la [console APIMart](https://apimart.ai/overview) :

* 📊 Statistiques d'appels
* 💰 Détails des coûts
* 📈 Tendances d'utilisation
* 🔍 Journaux des requêtes

## Conseils

### 1. Utilisez le contexte

* Ouvrez les fichiers connexes
* Référencez les fichiers avec `@filename`
* Référencez les dossiers avec `@folder`

### 2. Prompts clairs

**❌ Faible :**

```
optimize this
```

**✅ Fort :**

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

### 3. Itérer

Commencez petit → affinez → testez → ajustez les prompts.

### 4. Règles de projet

Définissez le style, le nommage, l'architecture et les tests dans `.cursorrules`.

## Fonctionnalités

Avec Cursor + APIMart :

* 💬 Chat pour les questions de codage
* ⚡ Complétion intelligente
* ✏️ Éditions en langage naturel
* 🔍 Compréhension plus profonde du code
* 🐛 Aide au débogage
* 📝 Docs et commentaires
* 🔄 Refactoring
* 🧪 Squelettes de test

## Support

* 📚 [Documentation 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="Commencer avec APIMart" icon="rocket" href="https://apimart.ai">
  Inscrivez-vous, obtenez votre clé API et livrez plus vite avec Cursor !
</Card>