# 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 с кодом и деталями.
