---
title: "401 — ключ не принят"
url: https://lumean.app/developers/docs/errors/401
locale: ru
description: "Запрос отклонён до всякой бизнес-логики: ни одного действия не выполнено, ничего не списано. Тело одинаковое у всех эндпоинтов: `{\"success\": false, \"message\": \"API key is missing. Provide it in the X-API-KEY header.\", \"data\": null}`. Анонимных запросов публичный контур не принимает нигде."
generated: 2026-10-17
---

# 401 — ключ не принят

- HTTP: `401`

- Заголовок `Retry-After`: нет

## Что произошло

Запрос отклонён до всякой бизнес-логики: ни одного действия не выполнено, ничего не списано. Тело одинаковое у всех эндпоинтов: `{"success": false, "message": "API key is missing. Provide it in the X-API-KEY header.", "data": null}`. Анонимных запросов публичный контур не принимает нигде.

## Почему

Заголовок `X-API-KEY` не отправлен, отправлен с опечаткой в имени или с обрезанным при копировании значением — либо ключ неизвестен, деактивирован или истёк. Bearer-токен веб-кабинета здесь не работает: публичный API авторизуется только ключом, и наоборот — ключ не открывает эндпоинты кабинета.

## Что делать

Убедиться, что заголовок называется ровно `X-API-KEY` (не `Authorization`, не `Api-Key`) и значение передано целиком. Если ключ верный — открыть раздел разработчика и проверить, что ключ активен и срок не вышел. Повторять запрос бессмысленно: 401 детерминирован, ретрай с тем же ключом даст тот же ответ.

## Следующий запрос

`GET /user` — самая дешёвая проверка ключа. 200 значит, что ключ жив; 403 тоже означает, что аутентификация прошла (у ключа просто нет права `profile.read`) — и только повторный 401 подтверждает, что дело в самом ключе.

## Смежное

- [Гайд: ключ, права и заголовки](https://lumean.app/developers/docs/guide/authentication)
- [GET /user](https://lumean.app/developers/docs/api/get-user)
- [Мои API-ключи](https://lumean.app/developers)
- [403 — прав не хватает](https://lumean.app/developers/docs/errors/403)

---

- Эта же страница в браузере: https://lumean.app/developers/docs/errors/401
- Машинный справочник целиком: https://api.lumean.app/docs/llm.md