Перейти к содержимомуKumoДокументация
Начало работы

Проверьте свой ключ

Единственная живая операция на этом сайте: вставьте ключ — и платформа прочитает вслух, что это за ключ и что ему разрешено.

Открыть как Markdown

Что она делает

Любой вызов модели через шлюз аутентифицируется тем же самым API-ключом. Эхо личности — та единственная, что отвечает о самом ключе, а не выводом модели: она читает вслух собственную запись предъявленного ключа. Именно поэтому ей место на сайте документации: это самый короткий честный ответ на вопрос «работает ли мой ключ» и единственный живой инструмент, который сайт запускает у себя.

Возвращается собственная запись ключа — имя, которое вы ему дали, маска префикса и хвост, по которым его узнают, чем он оплачивается, когда истекает, если истекает вообще, до чего дотягивается его область и на какой он версии. Секрета в этом ответе нет. Одна операция его всё же несёт — вызов, создающий ключ, отвечает им ровно один раз, и это единственный раз, когда его показывают, — а прочитать его потом нельзя ничем.

Ключ, который вы вводите, живёт в одном месте — в поле ниже — и покидает страницу только как bearer-заголовок одного запроса. Он никогда не пишется ни в хранилище, ни в куку, ни в адресную строку, ни в лог, и стирается со страницы, как только приходит ответ, — неважно, «да» этот ответ или «нет». Вторая проверка — это вторая вставка.

На отвергнутый ключ приходит одно предложение, а не четыре. Платформа намеренно отвечает одинаково на неизвестный, отозванный, истёкший и искажённый ключ: различать их значило бы превратить поверхность в оракул по ключевому материалу.

Запустите

Проверьте свой API-ключ

Вставьте ключ — и платформа ответит личностью самого ключа, а не выводом модели. Это самый быстрый способ узнать, работает ли ключ и до чего он дотягивается.

Как пишется заголовок → · Что означает каждый статус →