Перейти к основному содержанию

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.

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

Перед началом убедитесь:
  1. Cursor установлен
    Скачайте и установите подходящую версию для вашей ОС с сайта Cursor
  2. У вас есть API-ключ APIMart
    Войдите в консоль APIMart, чтобы получить API-ключ (начинается с sk-)
Совет: если у вас ещё нет аккаунта APIMart, сначала зарегистрируйтесь на APIMart и получите API-ключ.

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

После запуска Cursor откройте Settings:
  1. Нажмите значок ⚙️ Settings (шестерёнка) в правом верхнем углу
  2. Или используйте горячие клавиши:
    • Windows/Linux: Ctrl+Shift+J
    • macOS: Cmd+Shift+J
Cursor main interface

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

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

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

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

На странице настроек моделей:
  1. Найдите раздел OpenAI API Key
  2. Нажмите Add new или Override OpenAI Base URL
Важно: Cursor поддерживает OpenAI-совместимые API, поэтому APIMart можно настроить как кастомного провайдера.

2.3 Настройте APIMart

Введите следующее:
ПараметрЗначение
API KeyВаш API-ключ APIMart (sk-xxxxxxxxxxxx)
Base URLhttps://api.apimart.ai/v1
Важно: - Base URL должен включать суффикс /v1: https://api.apimart.ai/v1 - API-ключ должен быть ключом sk-... из консоли APIMart - После сохранения Cursor будет использовать модели APIMart для автодополнения и чата
APIMart API configuration

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

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

Model selection
В настройках моделей можно выбрать, какие модели использовать. Доступные семейства:
  • 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
Рекомендации: - 💰 Автодополнение (выгодно): gpt-4o-mini - 🚀 Сложные задачи (производительность): gpt-5, gpt-4o, claude-sonnet-4-5-20250929 - ⚡ Низкая задержка: gpt-4o-mini, gemini-2.0-flash-exp

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?»
    • «Помоги оптимизировать производительность этого кода»
    • «Объясни, как работает эта функция»
AI Chat panel

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

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

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

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

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

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

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

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

Попробуйте:
  1. Base URL — должен быть ровно https://api.apimart.ai/v1
  2. API-ключ — действительный ключ sk-... из консоли
  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:
  • 📊 Статистика вызовов
  • 💰 Разбивка расходов
  • 📈 Тенденции использования
  • 🔍 Логи запросов

Советы

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

Зарегистрируйтесь, получите API-ключ и ускорьте разработку в Cursor!