Интеграции
Проверенные инструкции для стандартных API SDK, AI CLI и фреймворков.
Документация
Со шлюзом работает любой клиент, который поддерживает стандартный протокол chat completion. Ниже перечислены интеграции, которые мы проверили лично: скопируйте конфигурацию, укажите ключ gw_ — и можно работать.
Если вашего инструмента нет в списке, схема всегда одна:
- Укажите в качестве base URL стандартного API адрес шлюза с суффиксом
/v1. - Используйте ключ
gw_…как API key. - Передавайте слаг модели из каталога, а не внутренний id upstream-модели.
Проверенные инструкции
Решение проблем
Если инструмент отклоняет ключ с общим сообщением «auth failed»:
- Сохранён ли префикс
gw_? Некоторые инструменты пытаются преобразовать ключ к форматуsk-…. - Равен ли base URL точно
<GatewayUrl/>/v1? Для OpenAI-совместимых клиентов суффикс/v1обязателен. - Включён ли слаг модели в каталоге? Отключённые модели возвращают 404, который некоторые инструменты показывают как ошибку авторизации.
Если ответы приходят, но вызовы инструментов не работают, upstream может не поддерживать function calling для этой модели. Проверьте capabilities модели в каталоге: capabilities.tools = true означает, что шлюз проверил вызов функций по всей цепочке.