API ROUTER.
Вход

Настройка Windsurf Editor

Инструкция по настройке инновационного AI-редактора Windsurf от Codeium. Подключение движка Cascade к инфраструктуре Api Router с сохранением умного контекста и терминальных действий.

Инновационный редактор Windsurf Editor от команды Codeium построен вокруг концепции «Flow» — непрерывного контекстного взаимодействия разработчика и агента Cascade. Агент умеет самостоятельно исследовать структуру модулей, запускать тесты в терминале и предлагать комплексные диффы. Наш шлюз обеспечивает прямое подключение к Cascade по стандарту OpenAI-compatible с минимальной задержкой.

1. Подготовка и получение ключа

Перед началом настройки убедитесь, что у вас есть активный аккаунт и действующий ключ авторизации:

  1. Перейдите в личный кабинет Api Router и пополните рублевый баланс (от 1 ₽).
  2. В разделе Ключи управления API создайте новый ключ (формат: sk-or-v1-...).
  3. Скопируйте ключ. Он понадобится для указания в поле API Key вашего редактора.

2. Конфигурация в Windsurf Editor

Откройте панель настроек редактора по пути: Windsurf Settings → Cascade → Custom OpenAI Compatible Provider. Укажите следующие параметры подключения:

Параметр настройки Значение для Api Router Описание
Base URL / Endpoint https://api-router.velar.plus/v1 Единая точка входа для всех запросов
API Key sk-or-v1-ваш-ключ Ваш секретный токен из кабинета
Provider Type OpenAI Compatible Стандартный протокол эмуляции

3. Рекомендуемые модели для работы с кодом

В Windsurf Editor вы можете вручную указать идентификаторы моделей, оптимизированных для архитектурных рассуждений, поиска багов и автодополнения. Ознакомиться с полным списком и ценами за токен можно в разделе Модели нейросетей:

  • anthropic/claude-sonnet
  • openai/gpt-mini
  • google/gemini-flash

4. Основные сценарии и горячие клавиши

После сохранения настроек шлюз мгновенно начинает маршрутизировать запросы на генерацию кода:

Комбинация клавиш Функциональное действие
Cmd + L / Ctrl + L Запуск Cascade в боковой панели с поддержкой контекстного поиска
Cmd + I / Ctrl + I Режим агентного внесения правок напрямую в открытые файлы
Tab Умное автодополнение с учетом архитектурных связей проекта

5. Проверка подключения и диагностика

Если редактор сообщает об ошибке соединения, проверьте следующие моменты:

  • Проверка баланса: Убедитесь в личном кабинете или через GET /v1/credits, что на балансе есть средства.
  • Формат Base URL: Убедитесь, что в конце адреса указан путь /v1 без лишнего слеша в конце: https://api-router.velar.plus/v1.
  • Резервирование: Для критических задач настройте резервные модели, чтобы избежать прерывания сессии при временной недоступности апстрима.
  • Лимиты ключа: Проверьте, не исчерпан ли лимит расходов в настройках ключа (контроль расходов).

Связанные разделы документации

Рекомендуем также изучить смежные технические руководства и спецификации: