> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ошибки invalid_api_key и 404: как задать базовый URL

> Исправьте ошибки invalid_api_key, 401 и 404 при работе с API-ключом LaoZhang API: задайте правильный базовый URL для SDK OpenAI, Anthropic и Gemini.

Ошибка `invalid_api_key` или 404 обычно означает, что запрос не дошёл до LaoZhang API либо в базовом URL неверный путь; сам ключ почти никогда не виноват. API-ключ LaoZhang API работает только с хостами LaoZhang API, настроенными так, как показано ниже.

| Параметр | Значение |
| - | - |
| Базовый URL для OpenAI SDK | `https://api.laozhang.ai/v1` |
| Базовый URL для Anthropic SDK | `https://api.laozhang.ai` (SDK сам добавляет `/v1/messages`) |
| Google Gen AI SDK | `base_url` равен `https://api.laozhang.ai`, `api_version` равен `v1beta` |
| Аутентификация | `Authorization: Bearer YOUR_LAOZHANG_API_KEY` |
| Быстрая проверка | `GET https://api.laozhang.ai/v1/models` |

## Как определить причину по ошибке

| Что вы видите | Вероятная причина | Что сделать |
| - | - | - |
| `Incorrect API key provided: sk-...` | API-ключ LaoZhang API отправлен на `api.openai.com` | Смените базовый URL на `https://api.laozhang.ai/v1` |
| 401 при уже заданном хосте LaoZhang API | Ключ скопирован не полностью или с пробелами либо токен отключён или просрочен | Скопируйте ключ заново и проверьте токен в разделе [Токены](https://api.laozhang.ai/token) |
| 404 Not Found | Для OpenAI SDK пропущен `/v1` либо для Anthropic SDK он добавлен | Сверьте путь с таблицей выше |
| `//` в пути запроса | В конце базового URL стоит `/` либо путь склеен дважды | Уберите завершающий слэш и позвольте SDK строить путь самому |
| Ошибки SSL или соединения | Нет `https://` либо ваша сеть не достаёт до хоста по умолчанию | Добавьте `https://` или попробуйте запасной хост ниже |

## Настройка каждого SDK

SDK строят пути запросов по-разному. OpenAI SDK добавляет только имя ресурса, поэтому его базовый URL должен содержать `/v1`. Anthropic SDK сам добавляет `/v1/messages`, поэтому с `/v1` в базовом URL получится `/v1/v1/messages` и ошибка 404.

> [tab] OpenAI SDK
>
> ```python theme={null}
> import os
> from openai import OpenAI
>
> client = OpenAI(
>     api_key=os.environ["LAOZHANG_API_KEY"],
>     base_url="https://api.laozhang.ai/v1",
> )
>
> response = client.chat.completions.create(
>     model="gpt-5.4-mini",
>     messages=[{"role": "user", "content": "Привет"}],
> )
> print(response.choices[0].message.content)
> ```

> [tab] Anthropic SDK
>
> ```python theme={null}
> import os
> import anthropic
>
> client = anthropic.Anthropic(
>     api_key=os.environ["LAOZHANG_API_KEY"],
>     base_url="https://api.laozhang.ai",  # без /v1
> )
>
> message = client.messages.create(
>     model="glm-5.2",
>     max_tokens=1024,
>     messages=[{"role": "user", "content": "Привет"}],
> )
> print(message.content[0].text)
> ```

> [tab] Google Gen AI SDK
>
> ```python theme={null}
> import os
> from google import genai
>
> client = genai.Client(
>     api_key=os.environ["LAOZHANG_API_KEY"],
>     http_options={"base_url": "https://api.laozhang.ai", "api_version": "v1beta"},
> )
>
> response = client.models.generate_content(model="gemini-3.8-flash", contents="Привет")
> print(response.text)
> ```

Перед запуском задайте переменную окружения `LAOZHANG_API_KEY`. Какие модели принимают формат Anthropic, смотрите в списке моделей раздела [Протокол Claude](https://docs.laozhang.ai/ru/api-reference/claude.md).

## Настройка через переменные окружения

Многие инструменты читают стандартные переменные окружения OpenAI, поэтому базовый URL можно не указывать в коде:

```bash theme={null}
export OPENAI_API_KEY="YOUR_LAOZHANG_API_KEY"
export OPENAI_BASE_URL="https://api.laozhang.ai/v1"
```

Если после смены URL ошибка осталась, поищите настройки, которые перекрывают друг друга:

* код, файл `.env` и оболочка задают разные URL;
* в стороннем клиенте сохранён прежний провайдер;
* процесс не перезапущен и всё ещё читает старые переменные.

В сторонних клиентах ищите провайдера «Custom API» или «OpenAI-compatible». Укажите `https://api.laozhang.ai/v1` как URL API, свой API-ключ LaoZhang API и полный ID модели из [каталога моделей](https://docs.laozhang.ai/ru/models.md).

## Проверка настройки одним запросом

```bash theme={null}
curl https://api.laozhang.ai/v1/models \
  -H "Authorization: Bearer $LAOZHANG_API_KEY"
```

Если в ответе есть массив `data`, ключ и хост заданы верно; в массиве перечислены модели, которые может вызывать этот токен. Если по-прежнему приходит 401, проверьте в разделе [Токены](https://api.laozhang.ai/token), что токен включён, не просрочен и у него осталась квота, либо создайте новый токен и повторите попытку.

## Запасные хосты

Все три хоста принимают один и тот же API-ключ, пути и параметры. Меняется только имя хоста:

* По умолчанию: `api.laozhang.ai`
* Прямое соединение из Европы или Северной Америки: `api-vip.laozhang.ai`
* Если `api.laozhang.ai` недоступен: `api2.laozhang.ai`

Полную настройку описывает [Руководство по подключению](https://docs.laozhang.ai/ru/api-manual.md).

## Не помогло?

Напишите на [hi@laozhang.ai](mailto:hi@laozhang.ai) и укажите:

* время запроса и часовой пояс;
* полный URL запроса (без ключа) и используемый SDK;
* HTTP-статус и полное тело ошибки;
* первые 6 и последние 4 символа ключа.

Никогда не присылайте ключ целиком. Если ключ попал в чат, на скриншот или в репозиторий, сначала отзовите его и замените, как описано в материале [Управление API-ключами](https://docs.laozhang.ai/en/faq/token-management.md).

## Связанные материалы

* [Руководство по подключению](https://docs.laozhang.ai/ru/api-manual.md)
* [Создание, хранение, ротация и отзыв API-ключей](https://docs.laozhang.ai/en/faq/token-management.md)
* [Проверка доступности моделей и прав доступа](https://docs.laozhang.ai/en/faq/model-availability.md)
* [API моделей: список доступных ID моделей](https://docs.laozhang.ai/en/api-reference/models.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.