> ## 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 в Cursor

> Подробное руководство по настройке и использованию API-сервиса APIMart в AI-редакторе кода Cursor. Этот гайд поможет настроить APIMart API в Cursor и получить доступ к большому набору AI-моделей для разработки.

## Предварительные требования

Перед началом убедитесь:

1. **Cursor установлен**\
   Скачайте и установите подходящую версию для вашей ОС с [сайта Cursor](https://cursor.sh/)

2. **У вас есть API-ключ APIMart**\
   Войдите в [консоль APIMart](https://apimart.ai/keys), чтобы получить API-ключ (начинается с `sk-`)

<Note>**Совет:** если у вас ещё нет аккаунта APIMart, сначала зарегистрируйтесь на [APIMart](https://apimart.ai) и получите API-ключ.</Note>

## Шаг 1: Откройте настройки Cursor

После запуска Cursor откройте Settings:

1. Нажмите значок **⚙️ Settings** (шестерёнка) в правом верхнем углу
2. Или используйте горячие клавиши:
   * 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 — откройте Settings из шестерёнки справа сверху*</caption>

## Шаг 2: Настройте параметры модели

### 2.1 Откройте настройки моделей

В Settings:

1. Найдите **Models** в левой боковой панели
2. Откройте страницу настроек моделей

<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>*Найдите «Models» в левой боковой панели*</caption>

### 2.2 Используйте OpenAI API Key

На странице настроек моделей:

1. Найдите раздел **OpenAI API Key**
2. Нажмите **Add new** или **Override OpenAI Base URL**

<Note>**Важно:** Cursor поддерживает OpenAI-совместимые API, поэтому APIMart можно настроить как кастомного провайдера.</Note>

### 2.3 Настройте APIMart

Введите следующее:

| Параметр     | Значение                                 |
| ------------ | ---------------------------------------- |
| **API Key**  | Ваш API-ключ APIMart (`sk-xxxxxxxxxxxx`) |
| **Base URL** | `https://api.apimart.ai/v1`              |

<Note>
  **Важно:** - Base URL должен включать суффикс `/v1`: `https://api.apimart.ai/v1` - API-ключ должен быть ключом `sk-...` из консоли APIMart - После сохранения Cursor будет использовать модели APIMart для автодополнения и чата
</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 Key и Base URL*</caption>

## Шаг 3: Выберите модели

### 3.1 Выбор моделей

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

В настройках моделей можно выбрать, какие модели использовать.

**Доступные семейства:**

* **GPT-4/5** — сильны в сложной генерации кода и Q\&A
  * `gpt-5` — последний GPT-5
  * `gpt-4o` — GPT-4o
  * `gpt-4o-mini` — быстрее, дешевле

* **Claude** — сильны в понимании и рефакторинге
  * `claude-sonnet-4-5-20250929` — Claude Sonnet 4.5
  * `claude-haiku-4-5-20251001` — Claude Haiku 4.5

* **Другие**
  * `gemini-2.0-flash-exp` — Google Gemini 2.0 Flash

<Tip>
  **Рекомендации:** - 💰 **Автодополнение (выгодно):** `gpt-4o-mini` - 🚀 **Сложные задачи (производительность):** `gpt-5`, `gpt-4o`, `claude-sonnet-4-5-20250929` - ⚡ **Низкая задержка:** `gpt-4o-mini`, `gemini-2.0-flash-exp`
</Tip>

### 3.2 Модели по функциям

Можно выбрать разные модели для разных функций:

* **Chat** — диалоги с ИИ
* **Autocomplete** — inline-подсказки
* **Cmd+K** — быстрое редактирование/генерация

Выберите подходящее под каждый рабочий процесс.

## Шаг 4: Начните использование

После настройки можно использовать AI-функции Cursor.

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

1. Нажмите `Cmd+L` (macOS) или `Ctrl+L` (Windows/Linux)
2. Задайте вопрос или задачу, например:
   * «Как реализовать quicksort?»
   * «Помоги оптимизировать производительность этого кода»
   * «Объясни, как работает эта функция»

<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>*Чат с ассистентом*</caption>

### 4.2 Дополнение кода

1. Печатайте как обычно в редакторе
2. Cursor предлагает дополнения
3. Нажмите `Tab`, чтобы принять

<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>*Пример inline-дополнения*</caption>

### 4.3 Быстрое редактирование (`Cmd+K` / `Ctrl+K`)

1. Выделите код
2. Нажмите `Cmd+K` (macOS) или `Ctrl+K` (Windows/Linux)
3. Опишите правку, например:
   * «Добавь обработку ошибок»
   * «Отрефактори эту функцию»
   * «Добавь аннотации типов»

<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>*Быстрая правка через Cmd+K*</caption>

### 4.4 Объяснение кода

1. Выделите код
2. Правый клик → **Explain with AI** (или горячая клавиша)
3. ИИ объяснит поведение и логику

## Часто задаваемые вопросы

### Q1: Не могу достучаться до APIMart?

**Попробуйте:**

1. **Base URL** — должен быть ровно `https://api.apimart.ai/v1`
2. **API-ключ** — действительный ключ `sk-...` из [консоли](https://apimart.ai/keys)
3. **Сеть** — убедитесь, что `https://api.apimart.ai` доступен; в некоторых регионах может потребоваться прокси

### Q2: Медленные ответы?

**Попробуйте:**

1. Используйте более лёгкую модель (`gpt-4o-mini` вместо `gpt-4o` или `gemini-2.0-flash-exp`)
2. Сократите контекст — отправляйте меньше кода, задавайте более точные вопросы
3. Проверьте задержку / прокси при необходимости

### Q3: Ошибки API?

| Сообщение                   | Вероятная причина          | Что делать                               |
| --------------------------- | -------------------------- | ---------------------------------------- |
| `401 Unauthorized`          | Неверный или истёкший ключ | Создайте ключ заново и обновите в Cursor |
| `429 Too Many Requests`     | Лимит запросов             | Подождите и повторите                    |
| `500 Internal Server Error` | Временная проблема сервера | Повторите позже                          |
| `insufficient_quota`        | Низкий баланс              | Пополните в консоли                      |

### Q4: Использование и биллинг?

Откройте [консоль APIMart](https://apimart.ai/overview):

* 📊 Статистика вызовов
* 💰 Разбивка расходов
* 📈 Тенденции использования
* 🔍 Логи запросов

## Советы

### 1. Используйте контекст

* Открывайте связанные файлы
* Ссылайтесь на файлы через `@filename`
* Ссылайтесь на папки через `@folder`

### 2. Чёткие промпты

**❌ Слабый:**

```
optimize this
```

**✅ Сильный:**

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

### 3. Итерации

Начните с малого → уточняйте → тестируйте → корректируйте промпты.

### 4. Правила проекта

Опишите стиль, именование, архитектуру и тесты в `.cursorrules`.

## Возможности

С Cursor + APIMart:

* 💬 Чат по вопросам кода
* ⚡ Умное автодополнение
* ✏️ Редактирование на естественном языке
* 🔍 Более глубокое понимание кода
* 🐛 Помощь в отладке
* 📝 Документация и комментарии
* 🔄 Рефакторинг
* 🧪 Скелеты тестов

## Поддержка

* 📚 [Документация 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="Начните с APIMart" icon="rocket" href="https://apimart.ai">
  Зарегистрируйтесь, получите API-ключ и ускорьте разработку в Cursor!
</Card>