RU ▾
https://api.unrestrictedaiapi.com/v1uncensored2026-10-06
Получить API-ключ

Ошибка LLM API 401: устранение сбоев аутентификации

Ошибка LLM API 401 означает, что сервер не смог аутентифицировать ваш запрос. В подавляющем большинстве случаев причина на стороне клиента: опечатка в заголовке, ключ с лишним символом или запрос, отправленный на неверный хост. Это руководство проходит по проверкам в порядке, который находит проблему быстрее всего.

Обновлено

Ключ, который не подходит к светящемуся замку, иллюстрирует сбой аутентификации при вызове LLM API

Ключевые моменты

  1. 401 — это ошибка аутентификации, а не лимит запросов или ошибка биллинга.
  2. Заголовок должен быть точно Authorization: Bearer YOUR_KEY, с одним пробелом и без кавычек.
  3. Ключ, отправленный на неверный базовый URL, терпит неудачу так же, как и неверный ключ.
  4. Сначала протестируйте с помощью curl; если curl работает, ошибка в конфигурации вашего приложения.

Сначала запустите этот тест curl

Прежде чем менять код, исключите приложение из уравнения. Эта одна команда отправляет минимальный допустимый запрос в API:

curl -i https://api.unrestrictedaiapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

GET /v1/models ничего не стоит, поэтому это безопасный способ проверить ключ. Флаг -i выводит строку статуса и заголовки.

  • 200 и список моделей: ключ в порядке. Ваше приложение отправляет что-то другое, поэтому перейдите к разделам о переменных окружения и базовом URL.
  • 401: неверен ключ или заголовок. Продолжайте со следующим разделом.
  • Ошибка подключения или DNS: неверный базовый URL, что является другой проблемой, отличной от 401.

Вставьте ключ вручную в этот тест, а не через переменную. Это исключит окружение из списка подозреваемых.

Причина 1: заголовок не совсем правильный

API ожидает Authorization: Bearer <key>. Небольшие отклонения все приводят к ошибке LLM API 401:

  • Authorization: YOUR_KEY, отсутствует слово Bearer.
  • Authorization: Bearer: YOUR_KEY с лишним двоеточием.
  • Authorization: Bearer "YOUR_KEY" с кавычками внутри значения.
  • Authorization: Bearer YOUR_KEY с двумя пробелами.
  • Заголовок с именем X-API-Key или api-key вместо Authorization. Это соглашения других сервисов.

Если вы используете SDK OpenAI, вы не пишете заголовок самостоятельно. SDK создает его из аргумента api_key. Если вы все равно видите 401, проблема в значении, переданном в SDK, а не в формате заголовка.

Причина 2: сам ключ поврежден

Ключи — это длинные случайные строки, поэтому ошибки копирования распространены и их трудно заметить невооруженным глазом.

  • Перенос строки или пробел в конце. Копирование из терминала или текстового файла часто добавляет их. Многие HTTP-библиотеки затем отправляют некорректный заголовок или ключ, который не совпадает.
  • Обрезанный ключ. Двойной щелчок выделяет только часть строки, если ключ содержит символы, которые прерывают выделение слов. Вместо этого используйте кнопку копирования на странице API-ключ.
  • Умные кавычки. Вставка через текстовый редактор или чат может заменить прямые кавычки на изогнутые.
  • Старый или замененный ключ. Если вы создали новый ключ, старый может больше не использоваться.

Чтобы проверить наличие невидимых символов в Python, выведите repr значения:

import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))

Если вторая строка выводит False, у вас есть пробелы вокруг ключа. Вызовите .strip() при его чтении.

Причина 3: неверный базовый URL

Это самая распространенная ошибка при переносе существующего приложения на нового провайдера. Ваш ключ действителен только на хосте, который его выдал. Базовый URL для этого сайта:

{"base_url": "https://api.unrestrictedaiapi.com/v1"}

Снова и снова повторяются два сценария сбоев:

  • Вы установили новый ключ, но оставили старый базовый URL. Запрос отправляется старому провайдеру, который отклоняет ключ, который он никогда не видел, и возвращает 401. Текст ошибки затем упоминает старого провайдера, что является полезной подсказкой.
  • Вы установили новый базовый URL, но оставили старый ключ в окружении. Запрос достигает нас, и мы отклоняем ключ другого провайдера.

Также проверьте путь. Базовый URL уже заканчивается на /v1, поэтому SDK добавляют /chat/completions к нему. Если вы вручную собираете URL, полный путь — это /v1/chat/completions, а не /v1/v1/chat/completions.

Причина 4: переменные окружения и файлы конфигурации

Если curl работает, но ваше приложение падает, значит, приложению подается другой ключ, чем вы думаете.

  • Переменная не экспортирована. В оболочке API_KEY=abc python app.py работает, но API_KEY=abc на отдельной строке не попадает в дочерние процессы. Используйте export.
  • Переопределено другим значением. Библиотеки могут автоматически читать OPENAI_API_KEY. Если в профиле оболочки установлено старое значение, оно может переопределить нужное.
  • Кавычки в файле .env. Некоторые загрузчики сохраняют кавычки как часть значения. Если ключ приходит в кавычках, удалите их или проверьте через repr.
  • Не перезапущено. Серверы и ноутбуки читают переменные окружения при запуске. Перезапустите после редактирования.
  • Разная среда в продакшене. Контейнеры, CI и панели хостинга имеют свои хранилища переменных. Выводите длину ключа, а не сам ключ, в логах.

Минимальная проверка на Python, подтверждающая конфигурацию

Этот скрипт использует SDK OpenAI и четко сообщает, если аутентификация не удалась:

import os
from openai import OpenAI, AuthenticationError

client = OpenAI(
    base_url="https://api.unrestrictedaiapi.com/v1",
    api_key=os.environ["API_KEY"].strip(),
)

try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Reply with the word ok."}],
        max_tokens=5,
    )
    print("auth ok:", r.choices[0].message.content)
except AuthenticationError as e:
    print("401:", e.status_code, e.response.headers.get("X-Request-Id"))

Если выводится X-Request-Id, укажите его при обращении в поддержку — это поможет команде найти ваш запрос. Аналогичная проверка для других языков приведена в быстром старте для пяти языков.

401 по сравнению с другими ошибками

Не тратьте время на аутентификацию, если ошибка другая. Краткая карта:

КодОбычное значениеКуда смотреть
401Отсутствующий или недействительный ключЗаголовок, ключ, базовый URL
429Лимит запросов или временная перегрузкаПодождите и повторите запрос; ограничения описаны в документации
400Некорректное тело запросаJSON, имя модели, параметры
404Неверный путьБазовый URL и эндпоинт

Проверьте также имя модели. Указывайте uncensored точно; неверный идентификатор модели — это ошибка запроса, а не 401. Подробное описание спецификации, включая принимаемые API эндпоинты и заголовки, доступно на странице Спецификация API, совместимая с OpenAI.

Прокси, браузеры и крайние меры

Два сценария вызывают 401, которые выглядят загадочно.

Прокси и шлюзы

Обратный прокси, API-шлюз или serverless-обёртка между вашим приложением и API могут отбрасывать или изменять заголовок Authorization. Протестируйте запрос с той же машины через curl и сравните результаты. Некоторые фреймворки передают заголовок только для запросов к тем же источникам (same-origin), поэтому пользовательская обёртка для fetch может молча потерять его при кросс-доменном вызове.

Ключи в коде фронтенда

Вызов API напрямую из JavaScript в браузере открывает ключ любому, кто откроет инструменты разработчика, а браузеры также могут блокировать запрос по причинам кросс-доменности, которые выглядят как ошибки аутентификации. Храните ключ на сервере, а фронтенд пусть вызывает ваш собственный эндпоинт, который, в свою очередь, вызывает API с прикреплённым ключом. Если ключ когда-либо был вставлен в публичный код или скриншот, замените его.

Всё ещё в тупике

Если только что скопированный ключ всё ещё возвращает 401 в тесте curl, сгенерируйте ключ заново на странице API-ключей, вставьте его напрямую в команду и попробуйте ещё раз. Если это не помогло, отправьте службе поддержки время запроса, эндпоинт и заголовок ответа X-Request-Id. Никогда не отправляйте полный ключ в сообщении; достаточно первых и последних четырёх символов для его идентификации.

Вопросы и ответы

Означает ли 401, что у меня закончился баланс?

Нет. 401 — это ошибка аутентификации: ключ отсутствует, имеет неверный формат или неизвестен. Истечение кредита — это отдельное состояние.

Почему тот же ключ работает в curl, но не в моём приложении?

Ваше приложение, вероятно, читает другое значение, например, старую переменную окружения, запись в .env в кавычках или ключ с пробелами в конце. Выведите длину и repr ключа, который фактически использует ваш код.

Могу ли я использовать свой ключ OpenAI с этим API?

Нет. Каждый ключ работает только на хосте, который его выдал. Используйте ключ со страницы API-ключей вместе с базовым URL этого сайта.

Взимается ли плата за 401?

Нет. За неудачные или отклонённые запросы плата не взимается.

Ваш ключ — всего в одной форме

Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.

Получить API-ключ