Windsurf свой API: проверка адреса и ограничений
Официальные страницы Windsurf описывают только ключ Anthropic для моделей Claude. Поля для своего адреса в них нет, поэтому подключение к шлюзу не подтверждено.
- Тип: Редактор и IDE
- Протокол: OpenAI Chat Completions
- Статус: Не подтверждено
Настройка
Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.
- Посмотрите в настройках моделей своей сборки Windsurf: если есть поле Base URL у собственного провайдера, заполните его как в примере, адрес с
/.v1 - Если такого поля нет, подключение невозможно: возможности BYOK различаются по версиям и тарифам.
- Для работы со шлюзом возьмите клиент с подтверждённой настройкой: Cursor, Cline, Continue или OpenCode.
Поля, если они есть в вашей сборке
Base URL: https://relay-llm.ru/v1
API Key: YOUR_API_KEY
Model ID: gpt-5.6-lunaПроверка
Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.
macOS и Linux
curl https://relay-llm.ru/v1/key \
-H "Authorization: Bearer $RELAY_API_KEY"Windows PowerShell
curl.exe https://relay-llm.ru/v1/key `
-H "Authorization: Bearer $env:RELAY_API_KEY"Windows cmd
curl https://relay-llm.ru/v1/key ^
-H "Authorization: Bearer %RELAY_API_KEY%"Затем проверьте сам клиент.
Если поле нашлось и вы его заполнили, отправьте «ping» и проверьте журнал запросов в кабинете. Записи нет: запрос ушёл не на шлюз.
Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.
Ограничения протоколов
OpenAI Chat Completions
Работают чат-модели каталога по пути /. Не поддерживаются /, /, /, /, Assistants и Realtime: функции клиента, которым они нужны, не заработают.
Ловушки
- Сторонние инструкции называют поле Base URL, но в официальной документации мы его не нашли. Документация переехала, страница о собственных ключах на момент проверки не открывалась.
- Часть сборок принимает только официальный ключ без редактируемого адреса. Ключ шлюза в такое поле не подойдёт.
- Пока в журнале запросов кабинета нет записи от этого клиента, считайте, что он не подключён: подсказки интерфейса про сторонний адрес не доказывают, что запрос ушёл на шлюз.
Ссылки
Официальная документация: Windsurf свой API: проверка адреса и ограничений
Подключение клиентов: общие сведения и все клиенты