API

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

Каждый вызов списывает токены с баланса ключа. Стоимость зависит от функции.

Заголовки оплаты#

На каждый платный ответ возвращаются:

http

X-Tokens-Cost: 3          # списано за этот вызов
X-Tokens-Remaining: 97    # остаток после вызова

Прозрачно и безопасно для баланса:

• Ошибки валидации (неверные параметры) — бесплатно, токены не списываются.
• Сбой проверки на нашей стороне (провайдер/движок) — токены возвращаются автоматически.
• Нет токенов — 402, вызов не выполняется.

Тарифы (токены каждый месяц) и разовые пакеты докупаются в боте. Новым аккаунтам начисляется пробный баланс.

json

{
  "ok": false,
  "error": "insufficient_tokens",
  "function_code": "profile_full",
  "required": 3,
  "available": 1
}

На каждый ответ приходят остатки лимитов ключа; превышение → 429.

http

X-RateLimit-Remaining-Minute: 9
X-RateLimit-Remaining-Day: 1990