Как подключить OpenCode к Tokenator API

Что получится в итоге

После настройки OpenCode перестаёт обращаться к своему стандартному провайдеру и отправляет все запросы в Tokenator. Оплата идёт токенами вашего ключа, а список доступных моделей задаётся ключом, а не инструментом.

Требования и поддерживаемые ОС

• Windows 10/11, macOS 12+ или современный Linux с 64-битной архитектурой.
• Доступ в интернет к домену Tokenator по HTTPS.
• API-ключ Tokenator вида sk-your-tokenator-key.

OpenCode запускается в терминале; конфиг — обычный JSON-файл, редактируется любым редактором.

Установка OpenCode

npm install -g opencode-ai

Проверьте установку командой opencode --version.

Настройка Tokenator

1. Зарегистрируйтесь в личном кабинете и купите пакет токенов.
2. Ключ появится в кабинете сразу после подтверждения оплаты — копировать его нужно целиком, вместе с префиксом.
3. В примерах ниже вместо настоящего ключа стоит плейсхолдер sk-your-tokenator-key. Не публикуйте настоящий ключ в репозиториях и скриншотах.

Конфигурация для Windows

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenator": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Tokenator",
      "options": {
        "baseURL": "https://api.tokenator.top/v1",
        "apiKey": "{env:TOKENATOR_API_KEY}"
      },
      "models": {
        "gpt-5.5": { "name": "gpt-5.5" }
      }
    }
  }
}

$env:TOKENATOR_API_KEY = "sk-your-tokenator-key"
opencode

Пакет @ai-sdk/openai-compatible работает с эндпоинтом /v1/chat/completions. Ключ лучше не писать в файл, а подставлять из переменной окружения синтаксисом {env:…}. Каждая модель, которую вы хотите видеть в переключателе, перечисляется в models.

Конфигурация для macOS и Linux

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenator": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Tokenator",
      "options": {
        "baseURL": "https://api.tokenator.top/v1",
        "apiKey": "{env:TOKENATOR_API_KEY}"
      },
      "models": {
        "gpt-5.5": { "name": "gpt-5.5" }
      }
    }
  }
}

export TOKENATOR_API_KEY="sk-your-tokenator-key"
opencode

Пакет @ai-sdk/openai-compatible работает с эндпоинтом /v1/chat/completions. Ключ лучше не писать в файл, а подставлять из переменной окружения синтаксисом {env:…}. Каждая модель, которую вы хотите видеть в переключателе, перечисляется в models.

Первый запрос

Перед запуском инструмента полезно убедиться, что ключ и модель рабочие. Один запрос curl отвечает на оба вопроса сразу.

curl https://api.tokenator.top/v1/chat/completions \
  -H "Authorization: Bearer sk-your-tokenator-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "ping"}]
  }'

cd /path/to/project
opencode

Успешный ответ означает, что ключ действителен, модель разрешена для этого ключа и апстрим доступен. Расход виден в кабинете сразу после запроса.

Переключение моделей

Все модели, которые должны быть доступны, перечисляются в блоке models конфига. После правки файла переключатель моделей внутри агента подхватит новый список.

Примеры ID моделей, доступных сейчас:

• claude-haiku-4-5
• claude-opus-4-6
• claude-opus-4-7
• claude-sonnet-4-6
• gpt-5.5
• deepseek-v4-flash

Актуальные ID и характеристики — в каталоге AI-моделей; там же видно, какие модели сейчас доступны. Выбрать между близкими вариантами помогает сравнение моделей.

Настройка reasoning

Если инструмент умеет передавать поле reasoning_effort в запросе, Tokenator пробрасывает его в апстрим без изменений. Дополнительно у самого ключа есть переключатель reasoning в личном кабинете — он действует независимо от инструмента.

Частые ошибки и способы исправления

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

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