К содержимому

Windsurf свой API: проверка адреса и ограничений

Официальные страницы Windsurf описывают только ключ Anthropic для моделей Claude. Поля для своего адреса в них нет, поэтому подключение к шлюзу не подтверждено.

  • Тип: Редактор и IDE
  • Протокол: OpenAI Chat Completions
  • Статус: Не подтверждено
Не подтверждено, 2026-10-02: официальные источники клиента не показывают возможности задать свой адрес. Не проверено вручную.

Настройка

Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.

  1. Посмотрите в настройках моделей своей сборки Windsurf: если есть поле Base URL у собственного провайдера, заполните его как в примере, адрес с /v1.
  2. Если такого поля нет, подключение невозможно: возможности BYOK различаются по версиям и тарифам.
  3. Для работы со шлюзом возьмите клиент с подтверждённой настройкой: Cursor, Cline, Continue или OpenCode.

Поля, если они есть в вашей сборке

text
Base URL: https://relay-llm.ru/v1
API Key: YOUR_API_KEY
Model ID: gpt-5.6-luna

Проверка

Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.

macOS и Linux

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

Windows PowerShell

bash
curl.exe https://relay-llm.ru/v1/key `
  -H "Authorization: Bearer $env:RELAY_API_KEY"

Windows cmd

bash
curl https://relay-llm.ru/v1/key ^
  -H "Authorization: Bearer %RELAY_API_KEY%"

Затем проверьте сам клиент.

Если поле нашлось и вы его заполнили, отправьте «ping» и проверьте журнал запросов в кабинете. Записи нет: запрос ушёл не на шлюз.

Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.

Ограничения протоколов

OpenAI Chat Completions

Работают чат-модели каталога по пути /v1/chat/completions. Не поддерживаются /v1/embeddings, /v1/audio/*, /v1/moderations, /v1/batches, Assistants и Realtime: функции клиента, которым они нужны, не заработают.

Ловушки

  • Сторонние инструкции называют поле Base URL, но в официальной документации мы его не нашли. Документация переехала, страница о собственных ключах на момент проверки не открывалась.
  • Часть сборок принимает только официальный ключ без редактируемого адреса. Ключ шлюза в такое поле не подойдёт.
  • Пока в журнале запросов кабинета нет записи от этого клиента, считайте, что он не подключён: подсказки интерфейса про сторонний адрес не доказывают, что запрос ушёл на шлюз.

Официальная документация: Windsurf свой API: проверка адреса и ограничений

Подключение клиентов: общие сведения и все клиенты

Обработка ошибок и повторы

Модели и ключ: список моделей в API

Ключи в кабинете

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key