OpenCode
OpenCode принимает любой провайдер, который говорит на OpenAI Chat Completions, поэтому API моделей это одна запись в opencode.json. Кроме самого OpenCode ставить ничего не надо. Модель auto сама выбирает модель каталога для разговора.
Что нужно: OpenCode (версию показывает opencode --version), ключ API моделей и деньги на балансе организации.
1. Создайте ключ
В консоли разработчика откройте «Ключи API», оставьте в поле Доступ вариант Ключ API моделей и создайте ключ. Секрет показывается один раз. Положите его в профиль оболочки (~/.zshrc, ~/.bashrc), чтобы OpenCode его прочитал:
2. Добавьте провайдер
Общая настройка OpenCode лежит в ~/.config/opencode/opencode.json; opencode.json в корне проекта действует только на этот проект. Если файла нет, создайте его, или добавьте запись provider в тот, что есть.
| Настройка | Что делает |
|---|---|
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_found | id модели в models нет в каталоге: возьмите его из GET /v1/models. |
402 | Баланс не покрывает резерв вызова или исчерпан лимит расхода ключа. |
| HTTP | type | Код | message | Повтор |
|---|---|---|---|---|
| 401 | authentication_error | invalid_api_key | The 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. | нет |
| 404 | not_found_error | model_not_found | The model does not exist. GET /v1/models lists the models this API sells. | нет |
| 400 | invalid_request_error | no_auto_model | No model meets the request for auto. | нет |
| 402 | billing_error | insufficient_balance | The 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. | нет |
| 402 | billing_error | key_limit_exceeded | This 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.