Інструменти та інтеграціїПосібник
Підключення DeepSeek Harness до CheapTokens: користувацький провайдер
Додайте користувацького OpenAI-сумісного провайдера в DeepSeek Harness, націльте його на API CheapTokens і запустіть перше завдання з програмування. Плюс що перевірити, якщо не вдається.
На цій сторінці
Щоб використовувати DeepSeek Harness із CheapTokens, відкрийте Settings → Models, перемкніть картку на Custom model API, встановіть базову URL-адресу https:/, виберіть OpenAI Chat Completions як протокол, вставте свій ключ CheapTokens і додайте ідентифікатор моделі deepseek-. Виберіть цю модель у виборі моделей, і наступна сесія працюватиме на ній.
Оце й увесь фокус. Решта цієї сторінки — точна форма, швидка перевірка, що ключ працює, перш ніж звинувачувати застосунок, і короткий список того, на що дивитися, коли шлюз відмовляє.
Налаштування нижче взяті з документації Harness станом на 24 жовтня 2026 року. Проєкт перебуває в публічному прев'ю, і його README попереджає, що відбуватимуться зміни, які порушують сумісність, тож якщо якийсь напис перемістився, довіряйте екрану та посібнику провайдера.
Що ви підключаєте#
DeepSeek Harness — це агент з відкритим кодом від DeepSeek (ліцензія MIT, побудований на архітектурі плагінів Cordis). Він постачається як настільний застосунок для macOS на Apple silicon і Windows 64-bit, або як вебінтерфейс, який ви запускаєте за допомогою npx @deepseek- (потрібен Node.js). Вебінтерфейс за замовчуванням відкривається за адресою http:/.
З коробки він просить ключ DeepSeek. Але на тому самому екрані Models є картка для всього, чого немає в його каталозі: релею, корпоративного шлюзу чи іншого провайдера. Саме цю картку ми й використовуємо.
З боку CheapTokens вам потрібні дві речі: ключ і баланс. Якщо ви ще не створили ключ, Ваш перший API-запит із CheapTokens займе пару хвилин, а Що таке API-ключ і як безпечно його зберігати розповідає, де його тримати.
Перевірте ключ, перш ніж відкривати Harness#
Один запит із термінала скаже вам, чи ключ, баланс і ідентифікатор моделі гаразд. Якщо це працює, а Harness — ні, проблема у формі, а не в акаунті.
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 hi in five words."}]
}'Ви маєте отримати відповідь у форматі JSON із масивом choices і блоком usage, який рахує вхідні та вихідні токени. Помилка у стилі Invalid API key означає ключ; повідомлення про баланс означає, що час поповнити.
Заповніть форму користувацького провайдера#
Відкрийте Settings → Models і перемкніть картку провайдера на Custom model API. Заповніть поля так:
Прокрутіть таблицю праворуч →
| Поле | Що ввести |
|---|---|
| Provider ID | cheaptokens (нижнім регістром; його не можна буде змінити пізніше, тож виберіть назву, яка вам до вподоби) |
| Display name | CheapTokens |
| Base URL | https:/ |
| API protocol | OpenAI Chat Completions |
| Credential | ваш API-ключ CheapTokens |
| Models | deepseek- |
Дві деталі збивають людей з пантелику. По-перше, базова URL-адреса — це https:/, точно як у curl вище, за винятком /. По-друге, ідентифікатор моделі — це повний ідентифікатор із префіксом deepseek-ai/. Коротка назва на кшталт deepseek- — це не те, що очікує API. Якщо хочете дізнатися більше про base_url і як його перемикати, дивіться OpenAI-сумісний API: що таке base_url і як його перемикати.
Також є кнопка Fetch available models. Документація каже, що вона звертається до GET /models і що ви завжди можете ввести ідентифікатор вручну. Ввести його вручну — безпечний шлях, тож зробіть це.
Виберіть модель і запустіть перше завдання#
Відкрийте вибір моделей і виберіть модель CheapTokens. Вибір моделі там робить її типовою для нових сесій, тож вам не доведеться повторювати це.
Тепер дайте їй щось маленьке й перевірне. Скажімо, у вас є проєкт із тестом, що не проходить:
Run the tests, find why test_parse_date fails and fix it. Show me the diff.Що ви хочете побачити: агент запускає команду тесту, читає файл, що не проходить, редагує його, знову запускає тести й показує diff. Якщо він це робить, з'єднання готове. Тепер ваш баланс оплачує цей цикл.
Чому дешева модель підходить для циклу агента#
Агент не надсилає одне запитання. Він надсилає всю розмову, списки файлів і вивід інструментів знову на кожному кроці, тож сесія — це переважно вхідні токени. Саме це робить рахунки агентів несподіваними (чому довга розмова коштує більше пояснює механіку, а Як оцінити вартість AI-агента дає метод).
Скажімо, сесія має 200 кроків, кожен крок надсилає близько 30 000 токенів контексту й отримує близько 600 токенів у відповідь. Це 200 × 30 000 = 6 000 000 вхідних токенів і 200 × 600 = 120 000 вихідних токенів. На DeepSeek-V4-Flash ця сесія коштує $0.102 за сьогоднішніми цінами, і загалом це дешевше, ніж OpenRouter, з урахуванням вхідних і вихідних токенів разом. Таблиця нижче використовує те саме навантаження для кожної моделі, яку ми пропонуємо:
| Модель | Вхід $/1М | Вихід $/1М | Вартість | OpenRouter |
|---|---|---|---|---|
| GLM-5.3-Flash | $0.02 | $0.04 | $0.125 | $0.257 |
| DeepSeek-V4-Flash | $0.015 | $0.10 | $0.102 | $0.304 |
| MiniMax-M2.7 | $0.05 | $0.15 | $0.318 | $1.94 |
6 000 000 вхідних і 120 000 вихідних токенів загалом. Ціни за 1 млн токенів актуальні та змінюються разом із нашими тарифами; стовпець OpenRouter показує довідкові ціни для того самого навантаження.
Для довгих сесій DeepSeek-V4-Flash дає вам контекстне вікно 380K, до 32 768 токенів в одній відповіді та одну ціну в будь-яку годину: без надбавки за пікові години. Він використовує той самий баланс, що й кожна інша модель CheapTokens, тож ви можете перемикати моделі в Harness без повторного поповнення. Поточні тарифи на сторінці цін, а сторінка моделі має більше про лінійку DeepSeek.
Хочете зробити сесію легшою? Додайте zai- (контекст 390K, до 8 192 вихідних токенів) або MiniMaxAI/ (контекст 180K, до 8 192 вихідних токенів) до того самого провайдера як додаткові ідентифікатори моделей. Один провайдер може містити кілька моделей, і вибір моделей дозволяє перемикатися між ними.
Якщо це не працює#
Документація Harness перелічує звичних підозрюваних. Ось вони разом із тим, що робити:
- Шлюз відхиляє кожен запит, хоча ключ і URL-адреса правильні. Форма запиту відрізняється від того, що очікує кінцева точка. Harness має налаштування сумісності для кожної моделі, як-от роль, що використовується для системного запиту, або назва поля вихідних токенів. Вони зберігаються в
$DSH_і перезавантажуються без перезапуску. Беріть точні ключі з посібника провайдера, а не вгадуйте їх.HOME/ profiles/ <profile>/ cordis. patch. yml - Меню зусиль відсутнє для моделі, яку ви ввели. Harness показує рівні міркування лише для моделей, які їх оголошують. У введеної вручну моделі жодного не оголошено, тож меню залишається порожнім. Оголошення рівнів — частина того самого файлу налаштувань для кожної моделі.
- 401 під час отримання моделей. Перевірте ключ або пропустіть кнопку й введіть ідентифікатор моделі самостійно.
- Відповідь обривається на півслові. Це обмеження токенів, а не розірване з'єднання; дивіться чому відповідь AI обривається на півслові.
- 401 або 403 у журналі від першого запиту. Повторіть перевірку через curl вище з тим самим ключем. Якщо curl працює, введіть ключ заново в полі Credential; зайвий пробіл у кінці — класика.
Якщо ви вже використовуєте інший агент із тим самим ключем, підключення OpenCode дотримується тієї самої схеми, а документація CheapTokens перелічує кожну кінцеву точку. Ще один інструмент у тій самій шухляді, один баланс.
Перш ніж закрити вкладку#
- Базова URL-адреса:
https:// api. cheaptokens. dev/ v1 - Протокол: OpenAI Chat Completions
- Ідентифікатор моделі:
deepseek-ai/ DeepSeek- V4- Flash- 0731 - Ключ: з вашого акаунта CheapTokens, який не потрапляє на скриншоти та в репозиторії
Запустіть завдання з тестом, що не проходить, один раз і подивіться на використання у вашому балансі. Цей один запуск скаже вам, скільки коштують ваші власні сесії.
