Як налаштувати курсор gate.ai у Cursor

Gate.AI сумісний спосіб підключення OpenAI дозволяє розробникам через API-ключ Gate.AI, базовий URL Gate.AI OpenAI та підтримуваний ID моделі підключити Cursor до Gate.AI (станом на червень 2026 року). Це особливо важливо для тих, хто хоче, щоб запити моделей у Cursor Chat, Composer, Agent або подібних інтерфейсах коду надсилалися через Gate.AI, а не за замовчуванням від постачальника моделей. Ця інструкція охоплює лише налаштування Cursor; для більш широкого інтеграційного процесу з API дивіться посібник з інтеграції Gate.AI API.

Попередні умови

• Встановлений Cursor.
• Маєте API-ключ Gate.AI.

Зміст базується на офіційній документації Gate.AI та доданих скріншотах налаштувань Cursor, станом на червень 2026 року.

Що ви зможете зробити після завершення цієї інструкції?

Після налаштування Gate.AI у Cursor ви зможете додати Gate.AI як власний маршрут моделі, ввести API-ключ Gate.AI та базовий URL, сумісний з OpenAI, обрати модель, наприклад deepseek/deepseek-v3.2, і використовувати цю модель у чатах або агентських інтерфейсах Cursor.

Ця інструкція охоплює лише налаштування через інтерфейс Cursor. Вона не включає SDK-інтеграцію, налаштування Claude Code, Claude Desktop або корпоративні права.

Крок 1: Відкрити налаштування Cursor

Цей крок відкриє область налаштувань Cursor для управління моделями та API.

Дія: у Cursor перейдіть у правий верхній кут і натисніть іконку налаштувань. Офіційна документація Gate.AI описує шлях до входу у Cursor як меню праворуч → Налаштування.

Перед зміною налаштувань моделі спершу зайдіть у Cursor через меню праворуч.

Крок 2: Відкрити налаштування моделі

Цей крок відкриє сторінку налаштувань моделей у Cursor.

Дія: у налаштуваннях Cursor з лівого меню оберіть Модель. Якщо список моделей не відображається повністю, натисніть Переглянути всі моделі. Офіційна документація Gate.AI вказує шлях до додавання власних моделей через Модель → Переглянути всі моделі.

У розділі моделей керуйте вбудованими моделями, власними моделями та API-настройками.

Крок 3: Натиснути "Додати власну модель"

Цей крок створить новий запис власної моделі для Gate.AI.

Дія: прокрутіть до низу списку моделей і натисніть Додати власну модель. Офіційна документація Gate.AI вказує, що шлях у Cursor для додавання власної моделі — це Модель → Додати власну модель.

Після додавання власної моделі з’явиться поле для введення ID моделі Gate.AI.

Крок 4: Ввести ID моделі Gate.AI

Цей крок повідомляє Cursor, яка модель підтримується Gate.AI для обробки запитів.

Дія: у Cursor введіть ID моделі Gate.AI і натисніть Додати. Формат: provider/model-name, наприклад deepseek/deepseek-v3.2. Офіційна документація Gate.AI зазначає, що ID моделі слід отримувати з маркетплейсу моделей і не використовувати auto.

Згідно з офіційною документацією Gate.AI (станом на червень 2026 року), ID моделі має формат provider/model-name, наприклад deepseek/deepseek-v3.2, що є підтримуваним прикладом.

Крок 5: Ввести API-ключ Gate.AI та базовий URL

Цей крок підключить API-ключ Gate.AI та базовий URL до поля, сумісного з OpenAI у Cursor.

Дія: у розділі API-ключ активуйте OpenAI API-ключ і вставте ваш API-ключ Gate.AI. Потім активуйте Перекрити базовий URL OpenAI і введіть:

Gate.AI офіційно вказує, що базовий URL для сумісності з OpenAI — це /openai/v1, а не просто /v1.

У Cursor введіть ID моделі Gate.AI, API-ключ і базовий URL.

Крок 6: Вибрати модель Gate.AI у Cursor Chat

Цей крок підтвердить, що Cursor може використовувати модель Gate.AI у чатах.

Дія: закрийте налаштування Cursor, відкрийте Cursor Chat, Composer, Agent або інший діалоговий інтерфейс і у виборі моделі оберіть додану модель. Офіційна документація Gate.AI вказує, що додані моделі доступні у Chat, Composer, Agent та інших інтерфейсах.

Ви повинні побачити у списку моделей назву доданої моделі, наприклад deepseek/deepseek-v3.2.

Після налаштування виберіть у списку моделей Cursor модель Gate.AI і надішліть команду.

Які значення потрібно ввести для налаштування gate.ai у Cursor?

| Поле Cursor | Значення для введення | Правила налаштування | | ------------------------ | ----------------------------------------------------------------- | ------------------------------------------------ | | Власний ID моделі | Приклад: deepseek/deepseek-v3.2 | Використовуйте формат provider/model-name, не auto. | | API-ключ OpenAI | Ваш API-ключ Gate.AI | Переконайтеся, що ключ дійсний і скопійований правильно. | | Перекрити базовий URL OpenAI | | Використовуйте /openai/v1, а не просто /v1. | | Вибір моделі | Ваша додана модель | Перед тестовими командами оберіть модель. |

ID моделі та базовий URL — найважливіші поля у конфігурації gate.ai у Cursor. Якщо Cursor приймає ключ, але не маршрутизує запити, спершу перевірте формат ID моделі та базовий URL, потім змінюйте інші налаштування.

Що робити, якщо Gate.AI у Cursor не працює? Перевірка несправностей

• Симптом: Cursor показує 401 або помилку з’єднання.

  • Причина: API-ключ Gate.AI недійсний, прострочений, скасований, вимкнений, скопійований неправильно або баланс закінчився.
  • Рішення: Перевірте статус API-ключа Gate.AI, скопіюйте його заново, переконайтеся, що баланс достатній. Офіційна документація Gate.AI зазначає, що неправильний ключ або недостатній баланс — поширені причини помилок автентифікації.

• Симптом: Cursor повідомляє, що модель недоступна або не знайдена.

  • Причина: Помилка у написанні ID моделі, неправильний формат provider/model-name або введено auto.
  • Рішення: Скопіюйте точний ID моделі з списку моделей Gate.AI і використовуйте конкретний, наприклад deepseek/deepseek-v3.2.

• Симптом: Cursor повертає помилку невідомого API-шляху або 404.

  • Причина: Базовий URL введено неправильно.
  • Рішення: Змініть значення на /openai/v1.

• Симптом: Власна модель не з’являється у Cursor Chat.

  • Причина: Не збережено налаштування Cursor або не оновлено список моделей.
  • Рішення: Збережіть налаштування, закрийте і перезапустіть Cursor, потім перевірте список моделей.

• Симптом: Одна модель доступна, інша — ні.

  • Причина: Вибрана модель не відповідає точному ID у Gate.AI або обмежена політиками облікового запису.
  • Рішення: Перевірте формат ID моделі у документації Gate.AI, а також обмеження облікового запису або політики безпеки.

Що далі налаштовувати або розробляти?

Якщо потрібно більш глибоке інтеграційне налаштування, звертайтеся до посібника з API Gate.AI. Там детально описано роль Gate.AI API у процесі розробки з OpenAI.

Для офіційних налаштувань користуйтеся документацією Gate.AI. Для вибору моделей — дивіться список моделей Gate.AI. Перед запуском у виробництво перевірте цінову політику Gate.AI.

Часті питання

Чи можу я використовувати auto як ID моделі у Cursor?

Ні. Офіційна документація Gate.AI вказує, що у конфігурації Cursor слід використовувати конкретний ID моделі з маркетплейсу, а не auto.

Який базовий URL Gate.AI потрібно вводити у Cursor?

Використовуйте /openai/v1. — офіційна документація підкреслює, що шлях має бути саме /openai/v1, а не просто /v1.

Після налаштування де обрати модель Gate.AI?

Відкрийте Chat, Composer, Agent або інший діалоговий інтерфейс і у виборі моделей оберіть додану модель.

Чому API-ключ працює в інших місцях, але не у Cursor?

Можливо, у Cursor використовується незбережений запис моделі, неправильний базовий URL або ID моделі. Перевірте правильність ID моделі, увімкнення API-ключа, базового URL і вибору моделі.