OpenCode

OpenCode принимает любой провайдер, который говорит на OpenAI Chat Completions, поэтому API моделей это одна запись в opencode.json. Кроме самого OpenCode ставить ничего не надо. Модель auto сама выбирает модель каталога для разговора.

Что нужно: OpenCode (версию показывает opencode --version), ключ API моделей и деньги на балансе организации.

1. Создайте ключ

В консоли разработчика откройте «Ключи API», оставьте в поле Доступ вариант Ключ API моделей и создайте ключ. Секрет показывается один раз. Положите его в профиль оболочки (~/.zshrc, ~/.bashrc), чтобы OpenCode его прочитал:

bash
export SAMRESHUUU_API_KEY="sk-org-your_api_key"

2. Добавьте провайдер

Общая настройка OpenCode лежит в ~/.config/opencode/opencode.json; opencode.json в корне проекта действует только на этот проект. Если файла нет, создайте его, или добавьте запись provider в тот, что есть.

json
{ "$schema": "https://opencode.ai/config.json", "provider": { "samreshuuu": { "npm": "@ai-sdk/openai-compatible", "name": "Сам Решу", "options": { "baseURL": "https://api.samreshuuu.ru/v1", "apiKey": "{env:SAMRESHUUU_API_KEY}" }, "models": { "auto": { "name": "auto", "variants": { "low": { "reasoningEffort": "low" }, "medium": { "reasoningEffort": "medium" }, "high": { "reasoningEffort": "high" } } } } } }, "model": "samreshuuu/auto" }
НастройкаЧто делает
npm@ai-sdk/openai-compatible заставляет OpenCode звать POST /v1/chat/completions. Пакет OpenCode скачивает сам при первом запуске.
options.baseURLАдрес API моделей. Оставьте /v1 в конце.
options.apiKey{env:SAMRESHUUU_API_KEY} читает ключ из окружения, и в файле его нет.
modelsМодели в выборе OpenCode. auto одна из них; другой может быть любой id со страницы «Модели».
variantsУровни рассуждений, которые OpenCode предлагает для модели; каждый уходит как reasoning_effort.
modelМодель, с которой начинаются новые сессии, в виде samreshuuu/<id>.

OpenCode не знает окна auto и рассчитывает сжатие разговора на окно по умолчанию. Если добавляете модель каталога с окном меньше, дайте ей "limit": {"context": …, "output": …} из context_length и max_output_tokens в GET /v1/models.

3. Запустите OpenCode

Запустите opencode и выберите модель через /models: модели API моделей называются samreshuuu/<id>. Проверить настройку без сессии можно командой opencode models: она перечисляет известные OpenCode модели, среди них samreshuuu/auto.

Отправьте запрос. Вызов появится в журнале вызовов консоли с моделью, которую выбрал auto, и его стоимостью. Инструменты работают как функции OpenAI: исполняет их OpenCode, вызывает модель.

Как отменить настройку

Уберите запись samreshuuu из provider и строку model, если она на неё указывает. OpenCode вернётся к другим вашим провайдерам.

Если что-то не так

Что видноЧто проверить
Моделей API моделей нет в /modelsФайл настроек не является корректным JSON, или SAMRESHUUU_API_KEY не задана в оболочке, из которой запущен OpenCode. Выполните opencode models.
401Ключ неверный или отозван. Проверьте его в «Ключах API» консоли.
404 на каждый запросВ baseURL нет /v1 в конце.
model_not_foundid модели в models нет в каталоге: возьмите его из GET /v1/models.
402Баланс не покрывает резерв вызова или исчерпан лимит расхода ключа.
HTTPtypeКодmessageПовтор
401authentication_errorinvalid_api_keyThe API key is unknown, disabled, revoked or expired. Switch a disabled key back on in the developer console; create a new one in place of a revoked or expired key.нет
404not_found_errormodel_not_foundThe model does not exist. GET /v1/models lists the models this API sells.нет
400invalid_request_errorno_auto_modelNo model meets the request for auto.нет
402billing_errorinsufficient_balanceThe organization balance does not cover this request (max_tokens is held in full until the answer is settled). Top up the balance or lower max_tokens.нет
402billing_errorkey_limit_exceededThis API key has reached its spending limit. Raise the limit or use another key.нет

Если ошибка не проходит, напишите в поддержку и приложите x-request-id ответа.

Частые вопросы

Загружает ли OpenCode список моделей из API?

Нет. OpenCode предлагает модели, перечисленные в models в opencode.json, и GET /v1/models для своего провайдера не запрашивает. Хватает auto: он выбирает модель каталога для разговора. Добавьте другие id со страницы «Модели», если хотите видеть их в выборе.

Можно ли OpenCode пустить через Responses API?

Да: с npm равным @ai-sdk/openai OpenCode зовёт POST /v1/responses, на нём API моделей тоже отвечает. Основной провод API моделей Chat Completions, поэтому на странице стоит @ai-sdk/openai-compatible.

Была ли страница полезна?