Перший запит до CheapTokens у Hoppscotch: ключ у середовищі

Ви можете зробити свій перший запит до CheapTokens у Hoppscotch, не встановлюючи нічого й не пишучи коду: відкрийте вебзастосунок, помістіть базову URL-адресу та ваш ключ у середовище, побудуйте один запит POST /chat/completions, натисніть Send. Відповідь і кількість токенів з'являться на панелі відповіді.

Єдине, що варто зробити уважно, — це ключ. Якщо вставити його прямо в запит, він потрапить на кожен скриншот і в кожне поширене посилання. Змінна середовища тримає його в одному місці.

Цей посібник спирається на офіційну документацію Hoppscotch (перевірено 9 листопада 2026 року; на сторінках немає версії чи дати). З боку API — базова URL-адреса CheapTokens https://api.cheaptokens.dev/v1, яка говорить у форматі OpenAI Chat Completions. Докладніше про обидва — у документації CheapTokens.

Помістіть базову URL-адресу та ключ у середовище#

У бічній панелі Hoppscotch є іконка Environments. Натисніть її, створіть нове середовище, назвіть його cheaptokens і додайте дві змінні:

Чому два типи? Згідно з документацією Hoppscotch, змінна Regular видима всім, хто бачить середовище, а Secret замаскована, ніколи не синхронізується й не поширюється, а також виключається з експортів і дублікатів. Ключ належить до другого типу: введіть його як значення змінної. Потім виберіть середовище cheaptokens, щоб запит його бачив.

У запитах змінна записується як <<name>>: <<baseURL>> і <<api_key>>. Ось і весь трюк.

Побудуйте запит#

REST — активний режим, коли ви відкриваєте Hoppscotch. Треба налаштувати три речі.

Метод і URL. Виберіть POST у випадаючому списку та введіть:

<<baseURL>>/chat/completions

Ключ. Вкладка Authorization у Hoppscotch має тип Bearer і додає токен до запиту як Bearer <token>. У документації не сказано, чи працює <<api_key>> у цьому полі токена, тож скористайтеся надійним шляхом: відкрийте вкладку Headers і додайте один заголовок.

Authorization: Bearer <<api_key>>

Ви ніде не замінюєте змінну вручну, і справжній ключ ніколи не з'являється в запиті, який ви бачите на екрані.

Тіло. Відкрийте вкладку Body, виберіть application/json у випадаючому списку Content Type (у документації його вказано як тип для вмісту у форматі JSON) і вставте:

{
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "messages": [
    {"role": "user", "content": "Explain what a token is in one sentence."}
  ],
  "max_tokens": 200
}

Використовуйте повний id deepseek-ai/DeepSeek-V4-Flash-0731. Коротку назву з прайс-листа API не прийме. DeepSeek-V4-Flash має контекст 380K і до 32 768 вихідних токенів на відповідь, тож 200 — навмисно малий ліміт для тесту. Хочете іншу модель? Змініть це одне поле на zai-org/GLM-5.3-Flash (контекст 390K, до 8 192 вихідних токенів) і надішліть знову.

Натисніть Send і прочитайте відповідь#

Натисніть Send. Розділ відповіді показує код стану, тіло, заголовки, cookie та час. Вам потрібен 200 і тіло JSON у формі, як у форматі OpenAI chat completion. Важливі два місця:

• choices[0].message.content — це відповідь моделі.
• usage містить prompt_tokens (те, що ви надіслали) і completion_tokens (те, що написала модель). Саме за це ви платите, тож тут ви перевіряєте, чи запит коштував стільки, скільки ви очікували.

Також подивіться на choices[0].finish_reason. stop означає, що модель завершила сама. length означає, що ваш max_tokens обірвав відповідь. Якщо ви бачите це на запитанні з одного речення, ліміт замалий. Докладніше — у AI answer cut off? Fix finish_reason "length".

Збережіть запит у колекцію, і він стане багаторазовим: змініть повідомлення, натисніть Send знову.

Скільки коштує тестовий запит#

Візьміть коротке запитання й коротку відповідь: скажімо, 30 токенів на вході та 150 на виході. Один такий запит коштує $0.000015, а жива таблиця нижче рахує 100 таких запитів разом із входом і виходом, поруч з OpenRouter.

Загалом, з урахуванням входу й виходу разом, це дешевше за OpenRouter для тієї самої моделі. Ваші власні цифри відрізнятимуться, тож посувайте повзунки під свій випадок:

Ціни фіксовані для кожної моделі, без пікових тарифів, і один баланс покриває всі моделі. Поточні тарифи — на сторінці цін.

Якщо не працює#

Більшість збоїв першого запиту в REST-клієнті походять із трьох полів. Зіставте симптом із причиною:

Для перших двох є повний розбір у API 401 or 404 error: wrong key, base URL or model id. Якщо ви не впевнені, який id використовувати, list models with GET /v1/models.

Куди рухатися далі#

Той самий запит працює в інших клієнтах: дивіться версію для Postman або файл .http для VS Code. Якщо ви волієте взагалі тримати ключі поза файлами й оболонками, store an API key safely охоплює основи. Id моделей і сумісний з OpenAI ендпоінт описано в документації.