Практический материал от команды Void API · 17 октября 2026

Подключите OpenCode к Void API — начните с модели и бюджета

Для независимых разработчиков и небольших команд, которым нужен внешний OpenAI-совместимый API для coding-агента. Ниже — конфигурация без секретов, расчёт стоимости токенов и чек-лист первой проверки.

Открыть кабинет и создать API-ключ Проверить модели и цены

Это материал самого Void API, не независимый обзор. OpenCode — сторонний проект; мы не заявляем аффилированность. Настройка ниже основана на документации, но end-to-end запрос с ключом в этом цикле не проверялся. Совместимость tools, streaming и Responses API зависит от модели.

1. Выберите модель и оцените токен-бюджет

Идентификаторы и ставки взяты из публичного каталога Void API. Это снимок, а не гарантия будущей цены или доступности для вашего ключа. Перед запуском сверяйте каталог и GET /v1/models.

Загружается снимок каталога…

Модель

Входные токены, без кэша
Выходные токены

Оценка: —

Формула: входные токены × входная ставка / 1 000 000 + выходные токены × выходная ставка / 1 000 000. Только токены без кэша; без оценки cache read/write и иных условий биллинга. Это не предсказание счёта: агент может многократно отправлять контекст и вызывать tools. Сначала измерьте один типичный небольшой сценарий и проверьте Usage в кабинете.

2. Сохраните opencode.json в корне проекта

Пример использует формат provider/options из интеграционной инструкции Void API. Перед использованием проверьте свою версию OpenCode: у V2 есть новый формат конфигурации; сверяйтесь с руководством миграции. Совместимость вашей установки здесь не проверялась.

Генератор работает в браузере. Не вводите сюда ключ: его ввод вообще не предусмотрен. Конфигурация ссылается на переменную окружения VOID_API_KEY.

Конфигурация появится после загрузки каталога.

В локальном Bash задайте ключ скрытым вводом (не вставляйте его в историю команд):

read -rsp 'Void API key: ' VOID_API_KEY; printf '\n'
export VOID_API_KEY
opencode

В OpenCode откройте /models и выберите Void API и нужную модель. Не перезаписывайте существующий config: объедините секцию provider вручную. Не публикуйте ключ и не добавляйте его в репозиторий. После работы: unset VOID_API_KEY.

3. Проверьте доступ до агентного сценария

curl --fail-with-body --max-time 30 \
  'https://void-api.tech/v1/models' \
  -H "Authorization: Bearer $VOID_API_KEY"

Проверьте, что выбранный ID присутствует в data[].id. Затем выполните минимальный запрос по API reference и только после этого включайте многошаговые задачи и инструменты. Запросы могут расходовать баланс.

401/403: проверьте gateway API-ключ, а не токен учётной записи; не публикуйте заголовок Authorization.
404 или model not found: проверьте baseURL с одним /v1 и точный ID модели. ID разных провайдеров не взаимозаменяемы.
Ошибка tools/streaming: начните с простого нестримингового запроса; затем отдельно проверьте функцию на выбранной модели.
Лимиты/баланс/5xx: проверьте кабинет и статус ответа; используйте ограниченные повторы, а не бесконечный цикл.

Как выбрать провайдера без обещаний «лучше всех»

Унифицированный API — не уникальная функция Void API. OpenRouter документирует единый endpoint и маршрутизацию между моделями; Together AI — API, SDK и запуск моделей. Сравните нужную модель, поддерживаемые tools, правила обработки данных, биллинг и измеренную стоимость своей задачи. Мы не проводили сравнительный бенчмарк и не заявляем превосходство по цене или скорости.

У Void API документированы OpenAI-совместимый gateway, публичный JSON-каталог цен и настройка OpenCode. Если это соответствует вашей задаче, начните с небольшой проверки в своём окружении.