Два смысла слова «токен»

Слово встречается в 23 материалах, и в двух совершенно разных значениях. Разберём, чтобы не искать ключ там, где считают деньги.

Токен как ключ доступа

Строка вроде sk-… или длинный набор букв и цифр. Её выдают сервис или программа, и она подтверждает: «этот запрос от того, кому разрешено».

Где встречается: «получите API-ключ», «вставьте токен в настройки», у нас на странице «Для агента».

Что важно:

• Это пароль. Кто получил — тот и вы.
• Хранить в переменных окружения или файле с правами 600, не в коде и не в репозитории.
• Отзывается у владельца. Если токен утёк — его отзывают, а не «надеются».

Токен как единица оплаты

Модель не читает буквы — она режет текст на куски, и каждый кусок стоит денег. Такой кусок и называют токеном.

Грубо: один токен — это три-четыре символа латиницы. Для русского хуже: кириллица режется мельче, и одна и та же фраза стоит больше токенов, чем её английский перевод.

Отсюда три практических следствия.

Цена зависит от объёма, а не от числа запросов. Длинный документ в контексте оплачивается при каждом следующем вопросе.

Русский дороже английского при том же смысле — иногда заметно.

Ответ тоже стоит. Считаются и вход, и выход, причём выход обычно дороже.

Как не перепутать

Если рядом слова «ключ», «доступ», «авторизация», «Bearer», «заголовок» — речь о доступе.

Если рядом «контекст», «окно», «лимит», «цена за миллион», «длина запроса» — речь о деньгах.

Что делать с этим на практике

С ключом: положить в файл окружения, дать программе прочитать при запуске, не печатать в чат и не отправлять в скриншотах. У нас это делает установщик: кладёт токен в ~/.local/share/polka-agenta/env с правами 600.

С оплатой: считать не «сколько запросов», а «сколько текста уходит в модель». Если инструмент подкладывает в каждый запрос весь проект — это дорого, даже если запросов мало.

Отдельно про наш токен

У «Агентской полки» токен — это только доступ. Он анонимный, живёт 180 дней, привязан к избранному и ничего не стоит. Модель мы не вызываем, за токены не платите.

Материалы по теме — на полке «Память» и в теме «Агенты».