Как подключить OpenCode к OpenAI-compatible API
OpenCode и другие AI-агенты могут работать через OpenAI-compatible провайдера. Для подключения нужны адрес API, секретный ключ и модель, доступная в текущем каталоге.
Подготовьте параметры
Создайте отдельный API-ключ для агента. Используйте OpenAI-compatible base URL https://api.normahub.cc/v1. Идентификатор модели получите через GET /v1/models: не копируйте имя из рекламного описания, если оно отличается от id.
- base URL: https://api.normahub.cc/v1
- ключ хранится в переменной окружения
- model берётся из актуального ответа /v1/models
Настройте совместимого провайдера
В конфигурации OpenCode выберите OpenAI-compatible тип провайдера и передайте base URL без добавления /chat/completions: клиент формирует маршрут сам. Название переменной секрета и точная структура конфигурации зависят от версии агента, поэтому сверяйте их с документацией установленной версии.
Проверьте коротким запросом
Сначала отправьте короткий текст без tools и большого контекста. Если он проходит, последовательно включайте streaming, инструменты и проектный контекст. При ошибке сохраните HTTP-статус и X-Request-Id.
- 401 — агент не передал ключ
- 404 — неверный base URL или id модели
- 429 — достигнут лимит ключа
- 503 — маршрут или модель временно недоступны