Сначала запустите этот тест 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. Никогда не отправляйте полный ключ в сообщении; достаточно первых и последних четырёх символов для его идентификации.
