OpenCode через API Токенмоста: v2 и v1

Как это устроено

OpenCode поддерживает пользовательский OpenAI-совместимый endpoint. В v2 используется providers и пакет @opencode/ai/providers/openai-compatible; в v1 схема другая. Адрес https://tokenmost.ru/v1 подходит для Chat Completions. Выберите пример для установленной версии.

Что потребуется

• Установленный OpenCode с известной версией и пустой тестовый проект.
• Положительный баланс и отдельный ключ Токенмоста с небольшим бюджетом и RPM.
• Точный ID текстовой модели с Chat Completions; для агента проверьте поддержку tools.

Порядок работы

1. Проверьте версию OpenCode и создайте отдельный ограниченный ключ.
2. Сохраните ключ в TOKENMOST_API_KEY в окружении терминала. Не записывайте секрет в файл проекта.
3. Для v2 добавьте opencode.jsonc из примера. Для v1 используйте отдельный пример v1; не смешивайте поля.
4. Замените MODEL_ID_FROM_CATALOG точным ID модели и запустите OpenCode в пустом тестовом проекте.
5. В /models выберите tokenmost/main для v2 либо tokenmost/MODEL_ID_FROM_CATALOG для v1 и задайте короткий вопрос. Затем проверьте чтение тестового файла.
6. Сверьте историю запросов и списания в кабинете. Только после проверки tools разрешайте изменение файлов и команды.

Готовая конфигурация

{
  "$schema": "https://opencode.ai/config.json",
  "model": "tokenmost/main",
  "providers": {
    "tokenmost": {
      "name": "Токенмост",
      "env": [
        "TOKENMOST_API_KEY"
      ],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://tokenmost.ru/v1"
      },
      "models": {
        "main": {
          "modelID": "MODEL_ID_FROM_CATALOG",
          "name": "Модель Токенмоста"
        }
      }
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "model": "tokenmost/MODEL_ID_FROM_CATALOG",
  "provider": {
    "tokenmost": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Токенмост",
      "options": {
        "baseURL": "https://tokenmost.ru/v1",
        "apiKey": "{env:TOKENMOST_API_KEY}"
      },
      "models": {
        "MODEL_ID_FROM_CATALOG": {
          "name": "Модель Токенмоста"
        }
      }
    }
  }
}

export TOKENMOST_API_KEY="sk-tm-..."

$env:TOKENMOST_API_KEY = "sk-tm-..."

Что учесть

Схемы v1 и v2 различаются. Подключение endpoint не гарантирует поддержку всех функций OpenCode выбранной моделью; тестируйте tools и расходы на ограниченном ключе.

Ошибки и диагностика

Источники и связанные инструкции

• Официальная схема OpenCode v2
• Официальная схема OpenCode v1
• Chat Completions Токенмоста
• Инструменты
• API-ключи

Читайте дальше

• Python: первый запрос к API Токенмоста
• JavaScript и Node.js: вызов API Токенмоста
• n8n: запрос к API Токенмоста через HTTP Request
• Модели и цены Токенмоста