Назад в блог

Начало работыИнструкция

Первый запрос к CheapTokens в Hoppscotch: ключ в окружении

Отправьте первый chat completion из веб-клиента Hoppscotch: базовый URL и ключ в окружении, JSON-тело и где смотреть ответ и usage.

Автор: CheapTokens TeamОпубликовано 4 мин чтения

Запрос в Hoppscotch: POST на базовый URL из окружения с ключом Bearer в переменной
Содержание
  1. Положите базовый URL и ключ в окружение
  2. Соберите запрос
  3. Нажмите Send и прочитайте ответ
  4. Сколько стоит тестовый запрос
  5. Если не работает
  6. Что дальше

Первый запрос к 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 и добавьте две переменные:

Переменная Тип Значение
baseURL Regular https://api.cheaptokens.dev/v1
api_key Secret ваш ключ CheapTokens

Зачем два типа? По документации Hoppscotch, Regular-переменную видит каждый, кто видит окружение, а Secret маскируется, не синхронизируется, не передаётся другим и не попадает в экспорт и копии. Ключу место во втором типе: впишите его как значение переменной. Затем выберите окружение cheaptokens, чтобы запрос его видел.

В запросах переменная пишется как <<имя>>: <<baseURL>> и <<api_key>>. Весь фокус в этом.

Поля запроса для Hoppscotch: URL, заголовок и JSON-тело (схема, не скриншот)
Запрос в том виде, как он собран в этом руководстве: метод, URL из окружения, заголовок, JSON-тело.

Соберите запрос#

При открытии Hoppscotch по умолчанию активен режим REST. Нужно задать три вещи.

Метод и URL. Выберите POST в выпадающем списке и введите:

text
<<baseURL>>/chat/completions

Ключ. На вкладке Authorization в Hoppscotch есть тип Bearer: он добавляет токен в запрос как Bearer <token>. Работает ли <<api_key>> внутри этого поля, в документации не сказано, поэтому берите надёжный путь: откройте вкладку Headers и добавьте один заголовок.

text
Authorization: Bearer <<api_key>>

Настоящий ключ вы нигде не подставляете вручную, и на экране в запросе его не видно.

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

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 и прочитайте ответ#

Нажмите Send. В разделе ответа видны код статуса, тело, заголовки, cookies и время. Нужен 200 и JSON-тело в формате chat completion от OpenAI. Важны два места:

  • choices[0].message.content — ответ модели.
  • usage — prompt_tokens (что вы отправили) и completion_tokens (что написала модель). Именно за это списываются деньги, поэтому здесь проверяют, что запрос стоил ожидаемо.

Посмотрите и на choices[0].finish_reason. stop — модель закончила сама. length — ответ обрезал ваш max_tokens. Если вы видите это на вопросе в одно предложение, лимит слишком мал. Подробнее — в «Ответ ИИ обрывается? finish_reason length и max_tokens».

Что смотреть в ответе
Поля, которые стоит читать в теле ответа. Значения — заглушки, а не записанный ответ.

Сохраните запрос в коллекцию, и его можно использовать снова: меняете сообщение — снова Send.

Сколько стоит тестовый запрос#

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

Модель За запрос 100 запросов OpenRouter, 100 запросов
GLM-5.3-Flash $0.0000066 $0.00066 $0.0013
DeepSeek-V4-Flash $0.000015 $0.0015 $0.0023
MiniMax-M2.7 $0.000024 $0.0024 $0.0288

30 входных и 150 выходных токенов на запрос. Цены за 1M токенов актуальны и меняются вместе с нашими тарифами; столбец OpenRouter показывает справочные цены для той же нагрузки.

В сумме, с учётом входа и выхода, это дешевле OpenRouter для той же модели. Ваши числа будут другими, поэтому подвигайте ползунки под свой случай:

Калькулятор стоимости

Сто тестовых запросов, как выше

Входные токены на запрос: 30 · Выходные токены на запрос: 150 · Запросов в день: 100

МодельВ деньВ месяц
GLM-5.3-Flash$0.00066$0.0198
DeepSeek-V4-Flash$0.0015$0.0464
MiniMax-M2.7$0.0024$0.072

Цены фиксированы для каждой модели, пиковых часов нет, а один баланс покрывает все модели. Текущие тарифы — на странице цен.

Если не работает#

Большинство сбоев первого запроса в REST-клиенте связано с тремя полями. Сопоставьте симптом и причину:

Найдите пары

Сопоставьте симптом и причину

  • 401 UnauthorizedКлюч не указан или неверный, либо заголовок Authorization не отправляется
  • 404 Not FoundНеверный путь в URL или неверный id модели
  • finish_reason равен "length"Лимит max_tokens обрезал ответ

Первые два случая подробно разобраны в статье «Ошибка API 401 или 404: ключ, базовый URL или id модели». Если не уверены, какой id брать, получите список моделей через GET /v1/models.

Что дальше#

Тот же запрос работает и в других клиентах: смотрите версию для Postman или файл .http в VS Code. Если хотите вообще не держать ключи в файлах и оболочке, основы собраны в статье «Как безопасно хранить API-ключ». Id моделей и OpenAI-совместимый адрес описаны в документации.