Общий принцип

API шлюза совместим с OpenAI, поэтому к AIaaS подключается любой инструмент, в котором можно задать собственный адрес эндпоинта. Настройка везде сводится к одному и тому же — трём параметрам.

Три параметра

Параметр	Что указывать
Базовый URL	Адрес шлюза с суффиксом /v1
API-ключ	Ваш персональный ключ, выданный при подключении
ID модели	Полный идентификатор из списка доступных

Адрес шлюза и ключ выдаются вместе — при подключении услуги.

warning

Ключ действует только на той площадке, для которой выдан. Обращение с ним на адрес другой площадки вернёт 401. Используйте адрес из вашего письма о подключении.

Тип провайдера

Большинство инструментов просят указать, по какому протоколу работать с провайдером. Выбирайте вариант, обозначенный как OpenAI-compatible: в разных инструментах он называется openai-compatible, @ai-sdk/openai-compatible, openai-completions или просто «OpenAI API».

Как получить список моделей

Идентификаторы моделей длинные и меняются по мере пополнения каталога. Актуальный список всегда отдаёт сам шлюз:

curl -H "Authorization: Bearer <ВАШ_КЛЮЧ>" \
  https://<адрес_шлюза>/v1/models

Описание моделей с назначением и контекстом — на странице доступные модели. Что выбрать под задачу — в подборе модели.

примечание

Идентификатор указывается целиком, вместе с суффиксом — например opr.deepseek4_flash.chat_completions. Сокращённые имена вроде deepseek шлюз не принимает.

Правила работы с ключом

• ключ персональный: не передавайте его коллегам, каждому выдаётся свой;
• не сохраняйте ключ в репозитории. Файлы конфигурации инструментов содержат его в открытом виде — добавьте их в исключения системы контроля версий;
• при подозрении на компрометацию запросите новый ключ в поддержке ITGLOBAL.COM: старый будет отозван.

Инструменты

Инструмент	Что это
Kilo Code	Расширение для VS Code: ассистент для написания и рефакторинга кода
OpenCode	Открытый агент для терминала, IDE и десктопа
OpenClaw	Агентская платформа с каналами связи и планировщиком
Hermes	Агентская платформа с профилями и разделением ролей

Для веб-интерфейса без установки локальных инструментов есть OpenWebUI.

Готовые скрипты

Для Kilo Code и OpenCode настройку можно не делать руками — в репозитории aiaas-scripts лежат скрипты для Linux, macOS и Windows. Они запрашивают список моделей через API, создают резервную копию текущей конфигурации и записывают провайдера.