Как подключить OpenCode к CheapTokens (opencode.json)

Чтобы подключить OpenCode к CheapTokens, добавьте собственного OpenAI-совместимого провайдера: сохраните API-ключ через /connect (ID провайдера cheaptokens), затем опишите провайдера в opencode.json с базовым адресом https://api.cheaptokens.dev/v1. После этого модели CheapTokens появятся в /models.

Инструкция следует документации OpenCode по провайдерам (страница обновлена 20 октября 2026 года; сверено 22 октября 2026 года). Тот же подход работает для других инструментов серии: Cline, Aider и Kilo Code.

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

• Установленный OpenCode (команда установки — в его документации для вашей платформы).
• API-ключ CheapTokens. Создайте его в личном кабинете и пополните баланс; один баланс работает для всех моделей. Основы — в документации CheapTokens.
• Данные API:
  • базовый адрес: https://api.cheaptokens.dev/v1
  • совместимость: OpenAI Chat Completions и Anthropic Messages
  • id модели в примере: deepseek-ai/DeepSeek-V4-Flash-0731 (контекст 380K, до 32 768 токенов в ответе). Список id — в документации CheapTokens: у разных провайдеров имена отличаются, поэтому копируйте id оттуда.

Шаг 1. Сохраните ключ через /connect#

1. Запустите OpenCode в проекте и выполните /connect.
2. Прокрутите список до пункта Other.
3. Введите уникальный ID провайдера: cheaptokens.
4. Вставьте API-ключ CheapTokens.

Этот шаг только сохраняет учётные данные. Адрес и модели провайдера OpenCode пока не знает — для этого нужен opencode.json.

Шаг 2. Опишите провайдера в opencode.json#

Создайте или откройте opencode.json и добавьте провайдера. Ключ в provider должен совпадать с ID, введённым в /connect.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cheaptokens": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CheapTokens",
      "options": {
        "baseURL": "https://api.cheaptokens.dev/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek-V4-Flash",
          "limit": {
            "context": 380000,
            "output": 32768
          }
        }
      }
    }
  }
}

За что отвечает каждая часть:

• npm — @ai-sdk/openai-compatible — пакет для эндпоинтов с /v1/chat/completions, как у CheapTokens. (Для эндпоинтов на /v1/responses OpenCode использует @ai-sdk/openai.)
• name — подпись в интерфейсе OpenCode.
• options.baseURL — адрес API CheapTokens.
• models — ключ — id модели; name внутри — отображаемое имя.
• limit.context / limit.output — необязательны; сообщают OpenCode окно контекста и максимальную длину ответа модели.

Ключ в переменной окружения (по желанию)#

Если не хотите хранить ключ в хранилище учётных данных OpenCode, добавьте apiKey в options с синтаксисом {env:VARIABLE}, который рекомендует документация:

"options": {
  "baseURL": "https://api.cheaptokens.dev/v1",
  "apiKey": "{env:CHEAPTOKENS_API_KEY}"
}

Затем задайте CHEAPTOKENS_API_KEY в своей оболочке. Не коммитьте настоящий ключ в репозиторий. Если с ключами вы только знакомитесь, прочитайте что такое API-ключ и как его хранить.

Шаг 3. Проверьте, что всё работает#

Выполните /models и выберите DeepSeek-V4-Flash у провайдера CheapTokens. Отправьте короткий запрос, например: «Опиши в трёх предложениях, что делает этот репозиторий». Нормальный ответ значит, что базовый адрес, ключ и id модели указаны верно.

Какую модель CheapTokens выбрать#

В models можно добавить сколько угодно записей — каждая это такой же блок со своим id.

Для сессии OpenCode, которая шлёт много запросов в цикле, DeepSeek-V4-Flash — хороший выбор по умолчанию: выход дешевле референсной цены OpenRouter, ответ может достигать 32 768 токенов, а у цены нет пиковых часов. MiniMax-M2.7 тоже дешевле референсных цен OpenRouter и по входу, и по выходу. У GLM-5.3-Flash выход тоже дешевле референсной цены OpenRouter. Актуальные цены (считаются при показе, числа не устареют):

Оценка рабочей сессии, например 20 запросов по 100 000 входных и 5 000 выходных токенов:

Больше — на странице цен и DeepSeek.

Если не работает#

• Провайдера или моделей нет в /models. Проверьте, что opencode.json — валидный JSON (без висящих запятых), а ключ в provider в точности равен ID из /connect. Если всё верно, перезапустите OpenCode.
• 401 / ошибка аутентификации. Повторите /connect и вставьте ключ заново либо проверьте переменную CHEAPTOKENS_API_KEY в оболочке, из которой запускается OpenCode.
• 404 или «model not found». id модели в models должен совпадать с id CheapTokens символ в символ, включая префикс (deepseek-ai/…).
• Ошибки соединения. Базовый адрес должен заканчиваться на /v1 без лишнего пути. См. частые ошибки подключения.
• «Not enough tokens». Пополните баланс; см. что означает ошибка.

Дальше#

Теперь OpenCode работает на CheapTokens, один баланс — на все модели. Получите ключ и сделайте первый запрос по документации CheapTokens.