> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/questions-answers/errors-description/llm/openai.md).

# OpenAI

Ошибки при работе с OpenAI: некорректные запросы, API-ключи, лимиты и доступность сервиса.

***

### `OPENAI_400_IMAGE` — не удалось обработать изображение

**Описание:** Некорректный запрос к OpenAI, не удалось обработать изображение

**Причина:** Изображение имеет недопустимый формат, повреждено или недоступно.

**Решение:** Проверьте формат изображения, убедитесь, что оно доступно и корректно закодировано (например, в base64).

***

### `OPENAI_400_IMAGE_URL` — ссылка на изображение некорректна или устарела

**Описание:** Некорректный запрос к OpenAI, ссылка на изображение некорректна или устарела

**Причина:** URL изображения недействителен, требует авторизации или ресурс удалён.

**Решение:** Убедитесь, что URL изображения публичный, активен и доступен без авторизации.

***

### `OPENAI_400_UNSUPPORTED_FILE` — неподдерживаемый тип файла

**Описание:** Некорректный запрос к OpenAI, загруженный тип файла не поддерживается. Используйте PDF.

**Причина:** Загружен файл в формате, который не поддерживается API.

**Решение:** Загружайте только PDF-файлы.

***

### `OPENAI_400_LENGTH` — превышен лимит символов в описании функции

**Описание:** Некорректный запрос к OpenAI, проверьте не превышены ли лимиты по количеству символов в описании одной из ваших функций, лимит символов составляет 1024 символа

**Причина:** Описание функции или параметра превышает 1024 символа.

**Решение:** Сократите описание функции до 1024 символов.

***

### `OPENAI_400_CONTEXT` — превышен лимит контекста диалога

**Описание:** Некорректный запрос к OpenAI, проверьте не превышен ли лимит контекста вашего диалога

**Причина:** История диалога слишком длинная.

**Решение:** Включите опцию оптимизации истории диалога в настройках агента или смените модель LLM с бо́льшим количеством контекста.

***

### `OPENAI_400_VALUE` — недопустимые символы в имени функции или параметра

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

**Причина:** В именах используются кириллица, пробелы или спецсимволы.

**Решение:** Используйте только латинские буквы, цифры, `_` и `-` в именах функций и параметров.

***

### `OPENAI_400_BASE64` — изображение должно быть в формате base64

**Описание:** Некорректный формат изображения. URL изображения должен быть в формате base64.

**Причина:** Изображение передано не в формате base64.

**Решение:** Перекодируйте изображение в base64 и укажите корректный MIME-тип.

***

### `OPENAI_400` — некорректный запрос (общий случай)

**Описание:** Некорректный запрос к OpenAI, обратитесь в техподдержку Nextbot

**Причина:** Структура или содержимое запроса не соответствуют требованиям API.

**Решение:** Проверьте структуру запроса. Обратитесь в поддержку Nextbot.

***

### `OPENAI_400_PARAMETERS` — дублирующиеся имена параметров

**Описание:** Некорректный запрос к OpenAI, проверьте корректность параметров вашей функции, вероятнее всего два или более параметров функции имеют одинаковые имена.

**Причина:** В описании функции указаны параметры с одинаковыми именами.

**Решение:** Убедитесь, что все параметры имеют уникальные имена.

***

### `OPENAI_400_UNSUPPORTED_TOOL` — Web-поиск не поддерживается моделью

**Описание:** Некорректный запрос к OpenAI, инструмент Web-поиск не поддерживается выбранной моделью. Пожалуйста, используйте другую модель или отключите несовместимый инструмент.

**Причина:** Выбранная модель не поддерживает инструмент веб-поиска.

**Решение:** Выберите модель, поддерживающую инструменты, или отключите веб-поиск.

***

### `OPENAI_400_MINIMAL_REASONING_FILE_SEARCH` — несовместимость уровня рассуждений и поиска в файлах

**Описание:** Уровень рассуждений «Минимальный» несовместим с «Поиском в файлах OpenAI». Установите уровень «Низкий» или выше.

**Причина:** При минимальном уровне рассуждений нельзя использовать поиск в файлах OpenAI.

**Решение:** Установите уровень рассуждений «Низкий» или выше в настройках модели.

***

### `OPENAI_400_ORGANIZATION_NOT_VERIFIED` — модель недоступна, требуется верификация организации

**Описание:** Выбранная вами модель недоступна для вашей организации. Для использования этой модели необходимо верифицировать организацию в OpenAI. Перейдите по ссылке и нажмите 'Verify Organization'. После верификации доступ может активироваться в течение 15 минут.

**Причина:** Организация в OpenAI не верифицирована.

**Решение:** Перейдите по [ссылке](https://platform.openai.com/settings/organization/general) и нажмите «Verify Organization». Подождите до 15 минут.

***

### `OPENAI_401` — неверный API-ключ

**Описание:** Неверный API ключ OpenAI, проверьте правильность введенного ключа в настройках агента

**Причина:** Ключ введён с ошибкой, отозван или недействителен.

**Решение:** Проверьте и переустановите API-ключ в настройках агента.

***

### `OPENAI_401_ACCOUNT_DEACTIVATED` — аккаунт OpenAI деактивирован

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

**Причина:** Аккаунт OpenAI заблокирован или приостановлен.

**Решение:** Проверьте почту, свяжитесь с поддержкой OpenAI или сервиса-посредника.

***

### `OPENAI_403_MODEL_NOT_FOUND` — модель недоступна, требуется активация

**Описание:** Выбранная вами модель недоступна для вашей организации. Для использования этой модели необходимо активировать её в настройках вашего аккаунта OpenAI. Перейдите по ссылке и активируйте. Если модель активирована, то требуется пересоздать API-ключ.

**Причина:** Модель не активирована для организации или требуется новый ключ.

**Решение:** Перейдите по [ссылке](https://platform.openai.com/settings/organization/limits), активируйте модель. При необходимости пересоздайте API-ключ.

***

### `OPENAI_404_MODEL_NOT_FOUND` — модель недоступна, требуется верификация

**Описание:** Выбранная вами модель недоступна для вашей организации. Для использования этой модели необходимо верифицировать организацию в OpenAI. Перейдите по ссылке и нажмите 'Verify Organization'. После верификации доступ может активироваться в течение 15 минут.

**Причина:** Организация не верифицирована.

**Решение:** Перейдите по [ссылке](https://platform.openai.com/settings/organization/general) и нажмите «Verify Organization». Подождите до 15 минут.

***

### `OPENAI_404_VECTOR_STORE_NOT_FOUND` — векторное хранилище не найдено

**Описание:** Векторное хранилище не найдено в вашей организации OpenAI. Возможно, оно было удалено или у вас нет доступа к нему. Проверьте наличие векторного хранилища в настройках вашего аккаунта OpenAI.

**Причина:** Хранилище удалено, переименовано или нет прав доступа.

**Решение:** Проверьте настройки аккаунта OpenAI, пересоздайте или переподключите векторное хранилище.

***

### `OPENAI_404` — ресурс не найден

**Описание:** Запрашиваемый ресурс не найден в OpenAI. Проверьте правильность названия модели или обратитесь в техподдержку Nextbot

**Причина:** Указана несуществующая модель или ресурс.

**Решение:** Проверьте название модели. Обратитесь в поддержку Nextbot.

***

### `OPENAI_422` — ошибка формата запроса

**Описание:** Ошибка в формате запроса к API. Обратитесь в техподдержку Nextbot

**Причина:** Запрос не прошёл валидацию на стороне OpenAI.

**Решение:** Обратитесь в техподдержку Nextbot.

***

### `OPENAI_429` — лимит запросов или закончился баланс

**Описание:** У вас закончились деньги в OpenAI или вы превысили лимит запросов, проверьте состояние вашего ключа

**Причина:** Исчерпан баланс или превышен rate limit.

**Решение:** Проверьте баланс и лимиты в [OpenAI Usage](https://platform.openai.com/usage). При необходимости пополните счёт или обновите подписку.

***

### `OPENAI_500` — внутренняя ошибка сервера OpenAI

**Описание:** Сервер OpenAI столкнулся с ошибкой при обработке вашего запроса. Попробуйте отправить запрос снова после короткого ожидания и напишите в техподдержу Nextbot, если проблема сохраняется.

**Причина:** Временный сбой на стороне OpenAI.

**Решение:** Подождите и повторите запрос. При повторении — обратитесь в поддержку Nextbot.

***

### `OPENAI_503` — высокая нагрузка на серверах OpenAI

**Описание:** Наблюдается высокая нагрузка на сервера OpenAI, в таких случаях отключаются в первую очередь пользователи с низким уровнем ключа. Проверить уровень своего ключа можно в настройках аккаунта OpenAI (<https://platform.openai.com/settings/organization/limits>)

**Причина:** Перегрузка серверов, приоритет отдаётся пользователям с более высоким тарифом.

**Решение:**

* Перейдите в [настройки OpenAI](https://platform.openai.com/settings/organization/limits)
* Проверьте уровень ключа и лимиты
* При необходимости повысьте тариф или дождитесь снижения нагрузки

***

### `OPENAI_UNKNOWN` — неизвестная ошибка OpenAI

**Описание:** Неизвестная ошибка в OpenAI

**Причина:** Ошибка не распознана или не классифицирована.

**Решение:** Повторите запрос. Проверьте стабильность API-ключа. Обратитесь в техподдержку Nextbot с кодом и деталями.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.nextbot.ru/questions-answers/errors-description/llm/openai.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
