OpenCode AI Gateway: Подключите несколько LLM через один API

Шлюз OpenCode AI предоставляет один стабильный уровень API между вашим рабочим процессом в терминале и моделями, которые вы действительно хотите использовать. Если вы управляете отдельными ключами провайдеров, отдельными страницами выставления счетов и отдельными рисками доступности, этот дополнительный уровень может сделать использование OpenCode намного проще в повседневной работе.

ShareAI хорошо подходит для этой роли, поскольку предоставляет один API для 150+ моделей, а также интеллектуальную маршрутизацию, резервирование и видимость на рынке. OpenCode уже поддерживает пользовательских провайдеров, совместимых с OpenAI, поэтому настройка в основном заключается в указании OpenCode на правильный базовый URL и добавлении модели, которую вы хотите использовать.

Это руководство является частью нашего Разработчики статьи о маршрутизации AI, доступе к моделям и интеграциях, готовых к производству.

Зачем вообще использовать шлюз OpenCode AI?

OpenCode разработан для работы с многими провайдерами, и его публичная документация показывает поддержку настройки пользовательских провайдеров, пользовательских baseURL значений и конечных точек, совместимых с OpenAI. Эта гибкость мощна, но также означает, что вы можете управлять каждым провайдером отдельно, когда все, что вам действительно нужно, — это чистый рабочий процесс кодирования.

• Один ключ API вместо одного ключа на каждого поставщика моделей.
• Одна поверхность выставления счетов вместо нескольких панелей управления.
• Более чистое переключение между моделями для быстрых правок, задач с длинным контекстом или более сложных переработок.
• Уровень маршрутизации, который может помочь, если провайдер работает медленно, недоступен или больше не подходит для задачи.

Для разработчиков, которые хотят гибкости без необходимости поддерживать отдельную инфраструктуру провайдеров, это обычно тот момент, когда шлюз AI начинает окупаться.

Как OpenCode поддерживает эту настройку

Согласно официальной документации провайдеров OpenCode, вы можете настроить параметры провайдера через opencode.json, установить пользовательский baseURL, и использовать @ai-sdk/openai-compatible для провайдеров, совместимых с OpenAI. Публичный репозиторий OpenCode на GitHub также документирует пути конфигурации и подтверждает, что инструмент создан для гибкости на уровне провайдера.

Это означает, что вам не нужен специальный пакет интеграции ShareAI, чтобы начать. Вы можете добавить ShareAI как пользовательский провайдер, сохранить свой API-ключ в переменной окружения и затем выбрать точную модель, которую вы хотите, чтобы OpenCode использовал.

Шаг 1: Создайте свой API-ключ ShareAI и выберите модель

Начните с генерации учетных данных в Создайте API-ключ. Затем просмотрите Маркетплейса моделей ShareAI чтобы решить, какая модель должна поддерживать ваш рабочий процесс OpenCode.

Практичный подход — выбрать одну модель по умолчанию для повседневных задач кодирования и держать одну или две альтернативы на случай, если вам нужна более низкая задержка, меньшая стоимость или более сильная модель рассуждений.

Шаг 2: Добавьте ShareAI как пользовательский провайдер в opencode.json

OpenCode позволяет вам определить пользовательского провайдера с совместимым с OpenAI конечным пунктом. Простой начальный шаблон выглядит так:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "shareai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ShareAI",
      "options": {
        "baseURL": "https://api.shareai.now/v1",
        "apiKey": "{env:SHAREAI_API_KEY}"
      },
      "models": {
        "your-shareai-model": {
          "name": "Choose a ShareAI model"
        }
      }
    }
  }
}

Заменить ваша-модель-shareai с точным идентификатором модели, которую вы хотите использовать из каталога моделей ShareAI. Держите API-ключ вне самого файла и загружайте его через переменную окружения.

export SHAREAI_API_KEY="your_api_key_here"

Если вам нужен более широкий формат запроса и детали аутентификации, Справочник API охватывает основной поток API ShareAI.

Шаг 3: Переключение моделей без перестройки вашей настройки

Как только ShareAI становится слоем провайдера, изменения моделей становятся намного проще. Вам больше не нужно перерабатывать аутентификацию поставщика каждый раз, когда вы хотите протестировать другую модель. Вместо этого вы сохраняете тот же API-интерфейс и меняете модель, на которую указывает OpenCode.

Это особенно полезно, когда ваш рабочий процесс кодирования меняется в зависимости от задачи. Вы можете захотеть одну модель для быстрых правок, другую для анализа больших репозиториев, и третью в качестве резервного варианта, когда стоимость или задержка важнее максимальной производительности. Вы можете сравнить варианты в рынок моделей и проверить поведение на адекватность в Песочница прежде чем выбрать модель по умолчанию.

Когда прямые ключи провайдера все еще имеют смысл

Все еще существуют случаи, когда прямое подключение разумно. Если вы зависите от специфической бета-функции провайдера, частного корпоративного соглашения или строгой настройки управления внутри провайдера, вы можете захотеть сохранить этот путь отдельно.

Но для команд, которые в основном хотят, чтобы OpenCode оставался гибким, портативным и более простым в эксплуатации, использование шлюза OpenCode AI часто является более чистым вариантом по умолчанию. Это уменьшает разрастание учетных записей и позволяет оценивать модели по производительности и соответствию, а не по тому, какой логин поставщика вы настроили последним.

Итог

Шлюз OpenCode AI — это не о добавлении большего количества инструментов ради этого. Речь идет о сохранении одного рабочего процесса кодирования, предоставляя себе возможность менять модели, сравнивать провайдеров и продолжать двигаться вперед, когда меняется базовый ландшафт моделей. Если это то, что вы хотите от OpenCode, ShareAI предоставляет вам практический способ сделать это через один API.