OpenCode Zen

Zen — необязательный сервис моделей с оплатой по использованию от OpenCode. Можно продолжать работу с другими провайдерами. Бесплатный клиент не означает бесплатную инференцию.

Подключение и выбор модели

1. Войдите в официальную консоль (opens in a new tab), проверьте оплату и скопируйте API-ключ.
2. В TUI выполните /connect, выберите OpenCode Zen и введите ключ. Не коммитьте учётные данные.
3. Через /models выберите модель, отправьте небольшой запрос без закрытых данных и проверьте расход.

Идентификаторы имеют вид opencode/<model-id>. Используйте актуальный каталог (opens in a new tab), не угадывайте названия. Для постоянного выбора укажите проверенный ID в model в конфигурации.

После подключения Zen эта конфигурация проекта выбирает GPT 5.5. При необходимости замените его другой доступной моделью из таблицы.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/gpt-5.5"
}

Протоколы и прямые API

Префикс API — https://opencode.ai/zen/v1/. В зависимости от модели используются responses с адаптером OpenAI, messages с Anthropic, chat/completions с совместимым адаптером или отдельные адреса Google. Используйте таблицу эндпоинтов ниже. Встроенное подключение Zen обрабатывает соответствие; не все модели используют Chat Completions.

Jev возвращает структурированные решения вместо текста через https://opencode.ai/zen/v1/systemone. Типы вопросов: noul, choice, score. Текущий ID и формат ответа смотрите в пример Jev ниже.

Список моделей и эндпоинты

В таблицах указаны ID, эндпоинты и цены Zen. Проверяйте доступность в актуальном каталоге: некоторые модели, оставленные в справочных таблицах, уже отключены. Префикс opencode/ используется в настройках клиента; прямые API-запросы используют ID без него.

Jev

Задайте ключ Zen в переменной окружения OPENCODE_API_KEY. Пример определяет срочность обращения: noul — вопрос да/нет, choice — именованные варианты, score — оценка по критериям. Пример отправляет запрос платной модели.

curl https://opencode.ai/zen/v1/systemone \
  -H "Authorization: Bearer $OPENCODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-1.13",
    "state": "My payments have failed for three days and I am losing sales. Please help now.",
    "questions": {
      "is_urgent": {
        "type": "noul",
        "instructions": "Does this request require urgent attention?"
      }
    }
  }'

Цены и расходы

Стоимость входа, выхода, кэша, длинного контекста и обработки платежей смотрите в таблице цен ниже и консоли. Бесплатные предложения могут закончиться и иметь другие условия данных. Отключённые модели проверяйте по текущему каталогу. Генерация заголовков сессий также может отражаться как расход небольшой модели.

Автопополнение списывает деньги при падении баланса ниже порога. Сумму можно изменить, функцию — отключить. Проверьте настройки перед запуском агента без наблюдения.

Месячный лимит использования ограничивает расход пространства или участника, а не сумму платёжных операций. Автопополнение может списать больше этого лимита. Проверяйте баланс, пополнение и ограничения вместе.

Цены за токены

Цены указаны в долларах США за миллион токенов. Вход, выход, чтение и запись кеша оплачиваются отдельно; учитывайте указанные диапазоны контекста. Прочерк не означает бесплатное использование. Изображения тоже могут создавать оплачиваемые токены, в том числе у DeepSeek V4 Flash Vision Exp.

Бесплатные модели

Для перечисленных моделей действует бесплатное предложение. Доступность и условия обработки данных различаются; это не обещание безлимитного или бессрочного бесплатного доступа. Jev возвращает структурированные решения и не заменяет текстовую модель для программирования.

• Big Pickle
• MiMo-V2.5 Free
• Ling 3.0 Flash Fin Free
• Nemotron 3 Ultra Free
• Nemotron 3.5 Lightning Free
• Muse Spark 1.3 Contributor Free
• Jev 1.13 Free

Пример расчёта

Для MiniMax M3 100 000 входных токенов без кеша и 20 000 выходных стоят 0,1 × $0.30 + 0,02 × $1.20 = $0.054, без других сборов. Повторные попытки и повторная передача контекста увеличивают расход. Указанная комиссия за платёж составляет 4,4% + $0.30 за транзакцию; проверяйте списание в консоли.

Автопополнение

Если ваш баланс опустится ниже $5, Zen автоматически пополнит его на $20.

Вы можете изменить сумму автопополнения. Также можно полностью отключить автопополнение.

Ежемесячные лимиты

Вы также можете установить ежемесячный лимит использования для всего рабочего пространства и для каждого участника вашей команды.

Например, предположим, что вы установили ежемесячный лимит использования в $20. Zen не будет использовать больше $20 в месяц. Но если у вас включено автопополнение, Zen может в итоге списать с вас больше $20, если ваш баланс опустится ниже $5.

Отключённые модели

Обработка данных

Прочитайте актуальные условия модели (opens in a new tab). Источник описывает размещение в США и правила хранения с исключениями; это не общая гарантия нулевого хранения.

Исключения включают хранение для API OpenAI и Anthropic, возможное улучшение моделей на данных некоторых бесплатных вариантов, журналы пробных NVIDIA API и обучение Muse Spark Contributor. Условия NVIDIA требуют не отправлять личные или конфиденциальные данные. Проверяйте конкретные условия и сроки соглашений.

Команды и свои ключи

Admin управляет моделями, участниками, ключами и оплатой; Member — только своими ключами. Администратор задаёт лимиты и отключает модели. Запрос к отключённой модели завершается ошибкой, что не доказывает неверность ключа. Временная бесплатность пространства не означает постоянную.

При использовании своего ключа OpenAI или Anthropic провайдер оплачиваемые токены выставляет напрямую, не через Zen. Проверяйте, какой аккаунт платит.

Роли

Вы можете приглашать коллег в свое рабочее пространство и назначать роли:

• Admin : управляет моделями, участниками, ключами API и выставлением счетов
• Member : управляет только своими ключами API

Администраторы также могут устанавливать ежемесячные лимиты расходов для каждого участника, чтобы держать затраты под контролем.

Доступ к моделям

Администраторы могут включать или отключать определенные модели для рабочего пространства. Запросы к отключенной модели будут возвращать ошибку.

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

Использование собственного ключа

Вы можете использовать свои собственные ключи API OpenAI или Anthropic, сохраняя доступ к другим моделям в Zen.

Когда вы используете собственные ключи, токены тарифицируются напрямую провайдером, а не Zen.

Например, у вашей организации уже может быть ключ для OpenAI или Anthropic, и вы хотите использовать его вместо того, который предоставляет Zen.

Ошибки

При 401/403 проверьте ключ, пространство и доступ; при отсутствии модели — ID и прекращение поддержки; при лимитах — баланс и расходы. См. сеть и устранение неполадок.

Связанные руководства

• Настройка провайдеров
• Выбор модели
• Сеть
• Устранение неполадок

Источник документации (MIT)