Check an API keyПроверка ключа
Paste a key and see whether the gateway accepts it, what is left on the balance and which models the key may call. The key is used for one lookup and is not stored.Вставьте ключ и посмотрите, принимает ли его шлюз, сколько осталось на балансе и какие модели ключу разрешены. Ключ используется для одной проверки и не сохраняется.
What the answer containsЧто показывает ответ
- Whether the key exists and is active. A revoked or expired key is rejected before any model is touched.Существует ли ключ и активен ли он. Отозванный или просроченный ключ отклоняется до обращения к модели.
- The balance in UT and the amount spent over the last 24 hours — this separates an empty balance from a wrong key.Баланс в UT и расход за последние 24 часа — это отличает пустой баланс от неверного ключа.
- The published models the key may call. An empty list means no profile is allowed, so every request returns 403.Опубликованные модели, которые ключу разрешены. Пустой список значит, что не разрешён ни один профиль и любой запрос вернёт 403.
Reading an errorЧто значит ошибка
- 401 invalid_api_key: the value is wrong, revoked, expired, or belongs to another service. Copy it from the cabinet again — a trailing space is the usual cause.401 invalid_api_key: значение неверное, отозвано, просрочено или относится к другому сервису. Скопируйте ключ из кабинета заново — чаще всего виноват лишний пробел.
- 402: the prepaid balance or the key's own spend limit is exhausted. The answer shows which one; top-up lives on the pricing page.402: закончился общий баланс или лимит расхода самого ключа. В ответе видно, что именно; пополнение — на странице цен.
- 403: the key is valid but a rule blocks the call — a model allowlist or an IP list. Edit the key instead of issuing a new one.403: ключ валиден, но вызов блокирует правило — список моделей или список IP. Правьте ключ, а не выпускайте новый.
- No status code at all: the request never reached the gateway. Check the network and the address before rotating keys.Нет кода ответа: запрос не дошёл до шлюза. Проверьте сеть и адрес, прежде чем менять ключи.
Privacy and costПриватность и стоимость
The key travels from this page to the backend over HTTPS and is used for one lookup. It is not written to browser storage, not echoed back and not added to the request journal.Ключ идёт с этой страницы на бэкенд по HTTPS и используется для одной проверки. Он не пишется в хранилище браузера, не возвращается в ответе и не попадает в журнал запросов.
The check spends no tokens: it reads the key record and the catalog, it does not call a model. Even so, test a new client with a dedicated key that has a spend limit and an expiry date — a leak then costs cents, not the balance.Проверка не тратит токены: она читает запись ключа и каталог, а не вызывает модель. И всё же для теста нового клиента берите отдельный ключ с лимитом расхода и сроком — тогда утечка стоит центов, а не баланса.
When to run itКогда проверять
- Right after issuing a key and before wiring it into an editor, a bot or a server.Сразу после выпуска ключа и до того, как вставить его в редактор, бота или сервер.
- When a client returns 401 or 403 and the key itself has not changed.Когда клиент возвращает 401 или 403, а сам ключ не менялся.
- After editing limits, an IP list or a model allowlist, to confirm the new rule took effect.После правки лимитов, списка IP или списка моделей — убедиться, что правило сработало.
Issue a keyВыпустить ключ · Setup instructionsИнструкции по подключению · API docsДокументация API · Models and pricesМодели и цены