Як підключити OpenCode до CheapTokens (opencode.json)

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

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

Що вам потрібно#

• Встановлений OpenCode (дивіться його документацію для вашої платформи).
• API-ключ CheapTokens. Створіть його у своєму акаунті та поповніть баланс; один баланс покриває всі моделі. Основи викладено в документації CheapTokens.
• Факти про API:
  • базова URL-адреса: 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 і додайте провайдера. ID провайдера в provider має збігатися з тим, який ви ввели в /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. (OpenCode використовує @ai-sdk/openai для ендпоінтів, побудованих на /v1/responses.)
• 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. Потім надішліть короткий запит, наприклад: "Summarize what this repository does in three sentences." Нормальна відповідь означає, що базова URL-адреса, ключ і 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/…).
• Помилки з'єднання. Базова URL-адреса має закінчуватися на /v1 і не містити зайвого шляху. Дивіться поширені помилки з'єднання.
• "Not enough tokens". Поповніть баланс; дивіться що означає ця помилка.

Наступні кроки#

Тепер у вас OpenCode працює на CheapTokens з одним балансом для всіх моделей. Отримайте ключ і зробіть свій перший виклик із документації CheapTokens.