Инструменты и интеграцииИнструкция
Подключить OpenHands к CheapTokens: модель, Base URL, ключ
Три поля в Settings > LLM (Advanced) — и OpenHands работает на модели CheapTokens. Плюс три частые ошибки и как их распознать.
Содержание
Запустить OpenHands на модели CheapTokens можно, заполнив три поля в Settings > LLM после включения Advanced: Custom Model (openai/), Base URL (https:/) и API Key. Вся настройка — это они. Дальше разберём, что значит каждое поле и как выглядит ошибка в любом из них.
Названия полей и правило для строки модели взяты со страницы документации OpenHands про OpenAI-совместимые адреса (сверено 8 ноября 2026; у страницы нет даты и версии). Последний релиз OpenHands на эту дату — v1.37.0 от 6 ноября 2026. Если подпись в вашей сборке чуть другая, ориентируйтесь на порядок: модель, адрес, ключ.
Что нужно до того, как открыть Settings#
Три вещи под рукой сэкономят лишний круг: ключ, id модели и доступ к Settings.
Чек-лист
Всё готово к настройке?
Если ключи и base URL пока в новинку, что такое base_url и как его сменить — на пару минут чтения, а список моделей через GET /v1/models покажет, как самому найти id.
Три поля#
Откройте Settings > LLM и включите Advanced. Поле Base URL находится под переключателем Advanced.
Документация описывает правило так: Custom Model — это openai/ и дальше имя модели, а если вы идёте через прокси со своим префиксом, то openai/. После openai/ идёт имя модели. У CheapTokens id — deepseek-, значит строка целиком: openai/.
Прокрутите таблицу вправо →
| Поле | Значение |
|---|---|
| Custom Model | openai/ |
| Base URL | https:/ |
| API Key | ваш ключ CheapTokens |
Почему эта модель для агента? У DeepSeek-V4-Flash окно контекста 380K и до 32 768 токенов в одном ответе, а цена одна в любое время суток — длинная сессия не дорожает в час пик. Кодовый агент на каждом шаге заново отправляет много контекста, и окно нужно именно для этого.
Хотите GLM? Впишите openai/ (контекст 390K, до 8 192 токенов в ответе) в то же поле, остальное не трогайте. Тот же баланс, тот же ключ, тот же Base URL.
Сначала проверьте всё вне OpenHands#
Прежде чем винить агента, отправьте один запрос с тем же адресом, ключом и id. Если он проходит, остаток проблем — в том, как вписаны поля.
curl https://api.cheaptokens.dev/v1/chat/completions \
-H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-ai/DeepSeek-V4-Flash-0731","messages":[{"role":"user","content":"Say ready"}],"max_tokens":20}'Обратите внимание, чего здесь нет: в значении model нет openai/. Префикс нужен OpenHands, а не API. В ответе будет блок usage с prompt_tokens и completion_ — те же два числа, которые потом складываются за сессию агента.
Сравнение
Строка модели: один префикс, два результата
Только id
deepseek- — форма для curl и API.
С префиксом
openai/ — форма для поля Custom Model.
Как выглядит неверное поле#
Причина может быть в любом из трёх полей:
- Неверный ключ. API отвечает 401 — ключа нет, он с опечаткой или со скопированным пробелом в конце.
- Неверный Base URL. Запрос уходит не туда, и вы получаете 404 или ошибку соединения. Адрес должен кончаться на
/v1, без лишнего пути. - Неверная строка модели. Либо нет префикса, либо после него не полный id (API принимает только полный
gateway_id, а не короткий id вродеdeepseek-).v4- flash- 0731
Подробнее про 401 и 404 — в статье ошибка API 401 или 404: ключ, base URL или id модели.
Попробуйте самиПопробуйте: ключ верный, адрес верный, а агент падает на первом шаге. Какое поле открыть?Показать ответ
Custom Model. Проверьте, что строка начинается с openai/ и что id после неё написан в точности как в таблице выше. Ключ и адрес легко проверить через curl.
Сколько стоит одна сессия#
Агент платит за весь контекст на каждом шаге, а не за вашу строчку задачи. Допустим, OpenHands разбирает баг 40 шагов: около 30 000 токенов на входе и 1 500 на выходе за шаг. Один шаг на DeepSeek-V4-Flash — $0.0006; сорок шагов — в таблице ниже, рядом с другими моделями и OpenRouter.
| Модель | Вход $/1M | Выход $/1M | За запрос | 40 запросов | OpenRouter, 40 запросов |
|---|---|---|---|---|---|
| GLM-5.3-Flash | $0.02 | $0.04 | $0.00066 | $0.0264 | $0.0452 |
| DeepSeek-V4-Flash | $0.015 | $0.10 | $0.0006 | $0.024 | $0.0924 |
| MiniMax-M2.7 | $0.05 | $0.15 | $0.0017 | $0.069 | $0.828 |
30 000 входных и 1 500 выходных токенов на запрос. Цены за 1M токенов актуальны и меняются вместе с нашими тарифами; столбец OpenRouter показывает справочные цены для той же нагрузки.
В сумме, с учётом входа и выхода, DeepSeek-V4-Flash для этой нагрузки выходит дешевле OpenRouter. Допущения можно менять: небольшая правка — 10 шагов, большой рефакторинг — 100. Актуальные цены — на странице тарифов, страница модели — дешёвый DeepSeek.
Уже работаете в OpenHands с другим провайдером?#
Тогда меняются три значения: Custom Model, Base URL, API Key. Остальное в проекте не трогается, и вернуться назад можно так же. Подключение к самому API описано в документации CheapTokens; похожая настройка в другом инструменте — подключение Aider.
