Інструменти та інтеграціїПосібник
Підключення OpenHands до CheapTokens: модель, Base URL, ключ
Заповніть три поля в OpenHands Settings > LLM (Advanced), щоб запустити агента на моделі CheapTokens, і навчіться розпізнавати три типові збої.
На цій сторінці
Ви можете запустити OpenHands на моделі CheapTokens, заповнивши три поля в Settings > LLM після ввімкнення Advanced: Custom Model (openai/), Base URL (https:/) та API Key. Це весь процес налаштування. Решта цієї сторінки — про те, що означає кожне поле і як виглядає ситуація, коли одне з них задано неправильно.
Назви полів і правило для рядка моделі походять зі сторінки документації OpenHands про OpenAI-сумісні ендпоінти (перевірено 8 листопада 2026 року; на сторінці немає дати чи версії). Останній випуск OpenHands на цю дату — v1.37.0 (6 листопада 2026 року). Якщо в вашій збірці якась назва виглядає трохи інакше, орієнтуйтеся за позицією: модель, base URL, ключ.
Перш ніж відкривати 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#
Перш ніж звинувачувати агента, надішліть один запит із тим самим URL, ключем та 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 після нього — не повний id (API приймає лише повний
gateway_id, а не короткий id на кшталтdeepseek-).v4- flash- 0731
Повне обґрунтування щодо 401 проти 404 — у API 401 або 404: неправильний ключ, base URL чи id моделі.
Спробуйте саміСпробуйте: ключ правильний, URL правильний, а агент усе одно падає на першому кроці. Яке поле ви відкриєте?Показати відповідь
Поле Custom Model. Перевірте, що воно починається з openai/, а id після нього написаний точно так, як у таблиці вище. Ключ і URL — найлегші для перевірки через curl.
Скільки коштує одна сесія#
Агент оплачує весь контекст на кожному кроці, а не лише ваше завдання в один рядок. Припустімо, OpenHands працює над багом 40 кроків, надсилаючи близько 30 000 токенів і записуючи назад 1 500 токенів на кожному кроці. Один крок на DeepSeek-V4-Flash коштує $0.0006; сорок таких — нижче, поруч з іншими моделями та OpenRouter.
| Модель | Вхід $/1М | Вихід $/1М | За запит | 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 вихідних токенів на запит. Ціни за 1 млн токенів актуальні та змінюються разом із нашими тарифами; стовпець OpenRouter показує довідкові ціни для того самого навантаження.
Загалом, з урахуванням вхідних і вихідних токенів разом, DeepSeek-V4-Flash виходить дешевшим за OpenRouter для цього навантаження. Припущення — ваші, їх можна змінювати: коротке виправлення може зайняти 10 кроків, великий рефакторинг — 100. Актуальні ціни — на сторінці цін, а сторінка моделі — дешевий DeepSeek.
Уже використовуєте OpenHands з іншим провайдером?#
Тоді ви лише замінюєте три значення: Custom Model, Base URL, API Key. Більше нічого в проєкті не змінюється, і ви можете повернутися назад так само. Покрокове підключення до самого API — у документації CheapTokens; схоже налаштування в іншому інструменті — підключення Aider.
