Документация API go2llm

OpenCode со своим API: custom provider go2llm

Чтобы использовать OpenCode со своим API, добавьте в opencode.json провайдера @ai-sdk/openai-compatible с baseURL: https://go2llm.tech/v1, передайте ключ go2llm и запустите модель как go2llm/claude-haiku-4-5. Связка OpenCode с go2llm проверена живым запросом через OpenAI Chat Completions.

Обновлено 27 сентября 2026 года. Если вы искали, как купить OpenCode Go, здесь другой способ оплачивать работу модели: go2llm списывает стоимость фактических API-запросов с общего баланса без обязательной ежемесячной подписки. Пополнить баланс можно рублями через СБП, а при регистрации на него зачисляется $1 — первый запуск пополнения не требует.

OpenCode Go и Zen: что это и как устроена оплата

OpenCode Go — месячная подписка на отобранные модели для задач кодинга. Её оформляют через аккаунт OpenCode Zen и получают отдельный API-ключ; для моделей заданы лимиты использования. Подробности — в официальной документации Go и в исходном описании OpenCode Go на GitHub.

OpenCode Zen — шлюз OpenCode к проверенным моделям. Для доступа добавляют платёжные данные и выпускают API-ключ; запросы оплачиваются по факту, баланс можно пополнять кредитами. Это описано в документации Zen и исходном описании Zen в репозитории.

Если оплатить Go или Zen не получается, подключите ключ go2llm как собственного провайдера OpenCode. Конфиг уже приведён в разделе «Как настроить custom provider в opencode.json».

В go2llm оплата списывается по факту за использованные токены, а модели выбираются по ID из каталога go2llm.

Что понадобится

Зарегистрируйтесь на go2llm и создайте ключ в кабинете: регистрация сама ключ не выпускает. Скопируйте его целиком, включая префикс gk_sk_. Для OpenCode используйте OpenAI-совместимый base URL https://go2llm.tech/v1 — у Anthropic SDK и Claude Code адрес другой.

Проверьте ID модели в открытом каталоге GET https://go2llm.tech/v1/models. OpenCode ходит через chat.completions, поэтому это значение должно быть в поле endpoints выбранной модели. Каталог меняется; скопированный из чужой инструкции ID может устареть.

Как настроить custom provider в opencode.json

Поместите файл opencode.json в проект или пользовательский конфиг ~/.config/opencode/opencode.json. Проверенный пример провайдера из документации инструментов:

{
  "provider": {
    "go2llm": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "go2llm",
      "options": { "baseURL": "https://go2llm.tech/v1" },
      "models": { "claude-haiku-4-5": {}, "gpt-5.6-luna": {} }
    }
  }
}

go2llm здесь имя провайдера внутри OpenCode. Ключи объекта models — точные ID из каталога go2llm. Если выберете другую модель, замените ID в конфиге и в команде запуска; одного изменения недостаточно.

Передайте ключ командой opencode auth login. В инструкции по инструментам описан и локальный вариант с "apiKey": "YOUR_API_KEY" в options; проектный конфиг с настоящим ключом не кладите в репозиторий.

Как проверить запрос

Отправьте короткую задачу через модель, которая перечислена в конфиге:

opencode run "Ответь одним словом: работает" -m go2llm/claude-haiku-4-5

Если OpenCode не отвечает, отделите его настройку от работы ключа. Тот же шлюз можно проверить запросом к POST /v1/chat/completions из примера OpenAI-совместимого API. При успешном запросе go2llm возвращает фактическую стоимость в usage.cost_usd; баланс своего ключа показывает GET /v1/me.

Ответ шлюзаЧто проверить
401 no-keyКлюч передан через opencode auth login и начинается с gk_sk_
404 model_not_foundID точно совпадает с GET /v1/models
400 model_protocol_mismatchУ модели в endpoints есть chat.completions
402 insufficient_balanceНа балансе хватает средств для резерва запроса
429 rate_limitНе исчерпан лимит запросов ключа; учтён Retry-After

Когда оплата по факту не подойдёт

При интенсивной работе счёт зависит от числа токенов и выбранной модели, а не от времени в редакторе. Смотрите все три колонки прайса — вход, выход и чтение кэша — на странице цен или в /api/pricing. На ключ можно поставить квоту в долларах и список разрешённых моделей. По умолчанию лимит составляет 20 запросов в минуту на ключ суммарно по моделям и endpoint'ам.

Живой прогон OpenCode подтверждает связку клиента со шлюзом, но не каждую модель и не каждый ваш сценарий. Если нужен именно интерфейс Cursor, начните со страницы «Чем заменить Cursor»: подключение самого Cursor к go2llm ещё не проверено.

Что дальше

Получить ключ и сделать первый запрос за 3 минуты — go2llm.tech.